Contents
Navigation
Home User Reference Other Resources


The QTPlgVideoDigitizerParamsDict class is a container of those video digitizers parameters that can be accessed and modified programmatically. It allows you to work using the same API interface whether with the parameters obtained by the traditional video digitizer components and with those obtained from the new Instrumentation and Industrial Control digitizer components.







The QTPlgVideoDigitizerParamsDict class constructors are called when you create a new instance of the class, while the ˜QTPlgVideoDigitizerParamsDict class destructor, is called automatically when the class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to nil.

You can not create valid instances of this class by yourself; instead, you will work with QTPlgVideoDigitizerParamsDict objects obtained by the of the class.

Once a new class instance is returned, it is good practice to check the class property to be sure that the new object can be used. See the validity requirements for more details.


The class provides you with the following initializer methods:
(other as QTPlgVideoDigitizerParamsDict)
This is the copy constructor. The properties of the object to be copied will be used to initialize the new class instance properties

specifies the current capabilities and state information of the video digitizer parameter identified by the key parameter; the key is a 32–bit integer value that specify the of the selected parameter. You can either walk through the dictionary keys by using the class property, or specify the parameters that you want to find about by providing their type by yourself. shows how to use the first approach to display a list of ; uses the second way to get information about a specific parameter. Which object is returned from this method depends on the type of the selected parameter; you can use the isA RealBasic operator to find about the type of the class instance obtained


/* supposing that exists a valid QTPlgVideoDigitizerParamsDict class instance named vdParamsDict */ dim param as QTPlgVideoDigitizerParam
dim i, count as integer=vdParamsDict.count()–1
dim s as string

for i=0 to count
param=vdParamsDict.value(vdParamsDict.key(i))

if param<>nil and param.isValid then
s=s+param.name+endOfLine
end if

next

msgBox s
/* supposing that exists a valid QTPlgVideoDigitizerParamsDict class instance named vdParamsDict, we try to retrieve the brightness parameter that has a OSType of ‘brit’ */ dim param as QTPlgVideoDigitizerParam
dim paramType as new QTPlgOSType("brit")

if paramType<>nil and paramType.isValid then
if vdParamsDict.hasKey(paramType.osType) then
param=vdParamsDict.value(paramType.osType)
if param<>nil and param.isValid then
/* do something here... */ end if
end if
end if