Contents
Navigation
Home User Reference Other Resources


This module stores a lot of video and audio related constants widely used by QTPlugin classes and methods. Also, it defines a few general purpose methods, useful when handling video and sound data.






(src as folderitem) as
you can use this method to create and initialize a new class instance from the image data contained into the QTPlugin image file specified by the src parameter. You can check the type of image returned by this function using the RealBasic isA operator
returns a class instance initialized with the data contained into the src file; if the specified file is not a QTPlugin image document or some other error occurs returns nil
[Deprecated]: since version 6.7 of the plugin this method is deprecated and will be removed from a future plugin version; use the shared method instead
(src as ) as
you can use this method to create a copy of the image data contained into the QTPlugin image object specified by the src parameter. You can use this function whenever you need a real copy of the specified image data, not just a reference to them (the Realbasic default behaviour)
returns a class instance initialized with the data contained into the src image; if some error occurs returns nil
[Deprecated]: since version 6.7 of the plugin this method is deprecated and will be removed from a future plugin version; use the shared method instead
(f as folderitem, byref err as integer) as picture
if QuickTime is able to handle the data contained into the file specified by the f parameter, this function returns a 100x100 pixels thumbnail of it. If the original picture dimensions do not fit into a square, then the picture will be scaled and centered into the thumbnail mantaining its original proportions
returns a RealBasic picture (nil on failure)
(p as picture, byref err as integer) as picture
use this function to obtain a 100x100 pixels thumbnail from the RealBasic picture specified by the p parameter. If the original picture dimensions do not fit into a square, then the picture will be scaled and centered into the thumbnail mantaining its original proportions
returns a RealBasic picture (nil on failure)
(byref err as integer) as
use this method to find about the sound input devices currently available to your machine. The result is a list of sound input devices names packed into a class instance. The names of the devices are contained into user data items of type "name", so, you can obtain the total number of sound input devices returned by using the class property setting the udType to "name"; then, you can retrieve the names of the devices by using the class method
returns an container with the list of sound input devices names. If some error occurs returns nil
() as
creates a movie from the contents of the scrap
returns a object if the scrap does contain a valid movie, otherwise returns nil
(i as integer, roi as , byref err as integer) as picture
capture an image of the indexed screen specified by the i parameter; this parameter can range between 0 (that is the main screen) and System.screencount–1. Do not specifying a valid roi will cause the entire screen to be captured; otherwise, just the portion of the screen indicated by the roi will be captured. As this method requires that an OpenGL renderer with full screen capablity exists, the screen capture could fail on some hardware configurations
returns a picture of the screen if successful, otherwise returns nil
Requires MacOS X 10.3 or later


the minimum value for audio render quality
a value that reduces quality for better performance
a value that represents a good quality/performance tradeoff
a value that increases quality but requires more computational resources
the maximum value for audio render quality
a QuickTime specific value that selects optimal settings for playback

specifies the minimum valid quality value
specifies low–quality image reproduction. This value should correspond to the lowest image quality that still results in acceptable display characteristics
specifies image reproduction of normal quality
specifies high–quality image reproduction. This value should correspond to the highest image quality that can be achieved with reasonable performance
specifies the maximum standard quality value
specifies lossless compression or decompression. This special value is valid only for components that can support compression or decompression

copy the pixels of the source without performing any modification
if the source is white, apply the foreground color to the destination; if the source is black, apply the background color; otherwise apply weighted portions of the foreground and background colors
replace the destination with a blend of the source and destination colors
replace the destination with the sum of the source and destination, up to a maximum value
replace the destination with the difference between the source and destination, but not less than a minimum value
replace the destination with the source if the source is not equal to the background
replace the destination with a dither mix of the source and destination
the color components of each pixel should be combined with the corresponding background pixel based on the value contained in the alpha channel. For example, if the alpha value is 0, only the background pixel will appear. If the alpha value is 255, only the foreground pixel will appear. If the alpha value is 127, then (127/255) of the foreground pixel will be blended with (128/255) of the background pixel to create the resulting pixel, and so on
the color components of each pixel have already been blended with a white pixel, based on their alpha channel value. Effectively, this means that the image has already been combined with a white background. To combine the image with a different background color, QuickTime must first remove the white from each pixel and then blend the image with the actual background pixels. Images are often pre–multipled with white as this reduces the appearance of jagged edges around objects
is the same as pre–multipled with white, except the background color that the image has been blended with is black instead of white
undocumented
the alpha channel is interpreted as a straight alpha channel, but when it draws, combines the pixels together and applies the supplied with the graphics mode to the alpha channel. This provides an easy way to combine images using both an alpha channel and a blend level. This can be useful when compositing 3D rendered images over video
is the same as pre–multipled with white or black, except the background color that the image has been blended with is the supplied with the graphics mode to the alpha channel

an aperture mode which gives compatibility with behavior in QuickTime 7.0.x and earlier. A movie in classic aperture mode uses track dimensions as set in . Movies default to classic aperture mode. If you modify the track property, the movie is automatically switched into classic aperture mode
an aperture mode for general display. Where possible, video will be displayed at the correct pixel aspect ratio, trimmed to the clean aperture. A movie in clean aperture mode sets each track’s dimensions to match the values specified into the property of the track property
an aperture mode for modal use in authoring applications. Where possible, video will be displayed at the correct pixel aspect ratio, but without trimming to the clean aperture so that the edge processing region can be viewed. A movie in production aperture mode sets each track’s dimensions to match the values specified into the property of the track property
an aperture mode for technical use. Displays all encoded pixels with no aspect ratio or clean aperture compensation. A movie in encoded pixels aperture mode sets each track’s dimensions to match the values specified into the property of the track property