v2.0
Returns the Image data associated with the clip.
Note: For performance considerations, try not only call this method
when the plug-in intends to read actual pixel values. For example, you
can determine the resolution more quickly via the Source
object, as demonstrated in one of the examples under the main
ImageClip topic.
Image ImageClip.GetImage( Object in_vFrame ); |
oReturn = ImageClip.GetImage( [Variant] ); |
Parameter | Type | Description |
---|---|---|
Variant | Variant |
Frame at which to retrieve the image. This is only meaningful
when the ImageClip represents an image sequence or movie file.
Default Value: Frame corresponding to the play cursor at the time that the ImageClip instance was created. |
NewScene , false set oImageClip = CreateImageClip( "$SI_HOME\Data\XSI_SAMPLES\Pictures\jio.jpg" ) set oImage = oImageClip.GetImage dim aPixelWanted(1,3) aPixelWanted(0,0) = 0 : aPixelWanted(1,0) = 0 aPixelWanted(0,1) = 0 : aPixelWanted(1,1) = 1 aPixelWanted(0,2) = 0 : aPixelWanted(1,2) = 2 aPixelWanted(0,3) = 0 : aPixelWanted(1,3) = 3 'Read the requested pixel values rgba = oImage.GetPixelArray( aPixelWanted ) for i=LBound(rgba,2) to UBound(rgba,2) logmessage "Pixel i :" & i LogMessage "R :" & rgba(0,i) LogMessage "G :" & rgba(1,i) LogMessage "B :" & rgba(2,i) LogMessage "A :" & rgba(3,i) next |