CLabels:new
The new method constructs a new instance of a CLabels object. The CLabels class includes data members that control calculation of centroid positions. Various constructor overloads are available to create a new CLabels and initialize the data members.
C = CLabels:new() Creates a default CLabels with data members initialized to default values. You will need to attach this to a CImageView object. C = CLabels:new( CImageView ) Creates a CLabels object and attaches it to the CImageView object. C = CLabels:new( CLabels2 ) |
This is a copy constructor. It creates a new CLabels object initialized to the members of theCLabels2 argument. You will need to attach this to a CImageView object.
If you use any constructor that does not use a CImageView object as an argument, then you must specify one using Attach method before labels can be drawn on an image.
Suppose a CImageView V exists and displays 1 or more images. The following script fragment illustrates two forms of the new constructor. Both produce the same result:
L = CLabels:new( V ) |
-- create a new CLabels L attached to V |
x = 192 ; y = 390 |
-- target coordinates |
str = "My label text" |
-- label coordinates |
I = V:GetImage() |
-- I is the current displayed image in V |
L:Add( I, x, y str ) |
-- draw the label on the image |
The following script fragment does the same thing but uses the 2-step attachment to a CImageView:
L = CLabels:new() |
-- create a new CLabels L |
x = 192 ; y = 390 |
-- target coordinates |
str = "My label text" |
-- label coordinates |
L:Attach( V ) |
-- attach to the CImageView V |
I = V:GetImage() |
-- I is the current displayed image in V |
L:Add( I, x, y str ) |
-- draw the label on the image |