CORIOmax Resolution Editor Programming Guide 2015/03/04

Transcription

1 CORIOmax Resolution Editor Programming Guide 2015/03/04

2 Document Information General Information: Title CORIOmax Resolution Editor Programming Guide Author Version 2.1 Brief Version Control: Version Amendments 2.1 Following review Marcel Roth, Paul Hounslow line interface guide for programming custom resolutions on CORIOmaster, CORIOmaster mini, CORIOmatrix and CORIOmatrix mini from firmware version M305. CORIOdiscover Resolution Editor guide for programming custom resolutions on CORIOmaster, CORIOmaster mini, CORIOmatrix and CORIOmatrix mini from firmware version M CORIOdiscover Resolution Editor and bug fixes for firmware version M Initial Release 0.6 CORIOgrapher Name restriction warning 0.5 Updated following review 0.4 US3215 Editable resolution US3217 Save custom resolutions US3345 Apply resolution to an in/output US3346 Custom Resolutions listed in Module menu US3414 Support custom resolution on inputs 0.3 US3214 Editing area for resolutions in menu 0.2 Added formatting 0.1 First Draft 2 Document Information

3 Contents Document Information... 2 Contents... 3 Overview... 5 Constraints... 5 Resolutions in CORIOmax... 6 Listing the Resolutions... 6 From CORIOdiscover Resolution Editor... 6 From the Line... 8 Resolution Properties... 9 Listing the Resolution Properties... 9 Name Aspect Can Framelock Pixel Clock Scan Type Horizontal Active Pixels Horizontal Front Porch Horizontal Sync Pulse Horizontal Back Porch Horizontal Synchronisation Polarity Vertical Active Pixels Vertical Front Porch Vertical Sync Pulse Vertical Back Porch Vertical Synchronisation Polarity CEAID Origin Line List of usable Resolutions by Name List of Resolutions by Index (output) Resolution by Index (output) Resolution (output) Set_Resolution (input) Measured_Resolution (input) Contents 3

4 Modify a Custom Resolution Using a Custom Resolution on an Input Configure an Output to use a Custom Resolution CORIOdiscover Resolution Editor Creating a Custom Resolution based on a built-in resolution Creating a Custom Resolution based on a standard Creating a Custom Resolution from scratch Editing an existing Custom Resolution Clearing an existing Custom Resolution Contents

5 Overview The CORIOmax series (CORIOmaster, CORIOmaster mini, CORIOmatrix and CORIOmatrix mini) support a vast majority of standard video resolutions, both Broadcast and Computing, as well as certain non-standard resolutions. These include the more commonly used resolutions from the following standards: CEA-861-D, VESA CVT, VESA GTF, VESA DMT In addition it is possible for our customers to add up to ten further Custom Resolutions Constraints Custom Resolution support is only available from firmware version M305 onwards. The CORIOdiscover Resolution editor is available from firmware version M306 onwards. Custom Resolutions cannot be used with SDI input or outputs. The Custom Resolutions are definable within the following constraints: All numeric values are in pixels unless otherwise stated. All numeric values are positive whole numbers or zero. String values may not contain spaces. String values may only be valid printable ASCII characters. String values are limited in the number of characters they may contain. Custom Resolutions do not support: Borders (any required border values are to be included in the Front and Back Porches). The pixel clock is limited to the following range: o 13.5MHz to 162MHz The value for the Active Video may not be zero. Interlaced Custom Resolutions require that: The Vertical Front and Back Porches are twice the even field. The Vertical Sync Pulse is twice the even value. The CEA identifier information option (CEAID) does not affect the Custom Resolution, it is there for providing attached equipment with information on the resolution. Only set this value when defining a Custom Resolution that complies with the CEA profile for that value. Warning: If the CEAID is non-zero and the Custom Resolution does not conform to the CEA Format for that then value then it is unlikely that an image will be displayed. Custom Resolutions become persistent after a SaveAllSettings operation. Overview 5

6 Resolutions in CORIOmax There are a number of standard video resolutions built-in to the CORIOmax (CORIOmaster, CORIOmaster mini, CORIOmatrix and CORIOmatrix mini) products. In addition there are 10 Custom Resolutions configurable by the user. These Custom Resolutions may be configured either from CORIOdiscover or the Line. Listing the Resolutions From CORIOdiscover Resolution Editor From version 1.1 the CORIOdiscover application includes a Resolution Editor. Start the CORIOdiscover application: Select the device to have the Custom Resolution and press the Resolution Editor button. This will prompt you for the administration username and password before allowing you to modify the system at this level. Once you have successfully logged in you will be presented with the Resolution Editor main window: By default all the Resolutions, built-in and custom, are shown. To see the Custom Resolutions you may scroll to the bottom of the list or select the custom only radio button: 6 Resolutions in CORIOmax

7 As can be seen from the above images the built-in resolutions have only a Copy button, whereas the Custom Resolution fields have Copy, Edit and Reset buttons. Resolutions in CORIOmax 7

8 From the Line The Resolutions command (in the Resources menu) contains 10 Custom Resolutions. Each resolution can be tailored to your exact requirements from the command line by configuring all the provided attributes. Name Resolution1000 AspectRatio Resolution1001 Resolutions Origin root Resources Resolution1009 Resources.Resolutions Figure 1 Custom Resolution command menu structure Custom Resolutions are accessed from the Resources menu in the Resolutions option. All the Built-in and Custom Resolutions configurations may be viewed from this menu item, in addition the Custom Resolutions may be modified. Built-in Resolutions are numbered from 1 onwards and Custom resolutions are numbered from 1000 with 10 Custom Resolutions available for use, from Resolution1000 to Resolution1009: Resources.Resolutions.Resolution1 Resources.Resolutions.Resolution2 Resources.Resolutions.Resolution1000 Resources.Resolutions.Resolution1009 8

9 Resolution Properties Listing the Resolution Properties Resources.Resolutions.Resolution1 List the attributes of this resolution. The Built-in Resolution 640x480p60 has the following configuration: Resources.Resolutions.Resolution1 Resources.Resolutions.Resolution1.Name = 640x480p60 Resources.Resolutions.Resolution1.Aspect = 4:3 Resources.Resolutions.Resolution1.CanFramelock = No Resources.Resolutions.Resolution1.PixelClock = Resources.Resolutions.Resolution1.ScanType = p Resources.Resolutions.Resolution1.HActive = 640 Resources.Resolutions.Resolution1.HFrontPorch = 16 Resources.Resolutions.Resolution1.HSyncPulse = 96 Resources.Resolutions.Resolution1.HBackPorch = 48 Resources.Resolutions.Resolution1.VActive = 480 Resources.Resolutions.Resolution1.VFrontPorch = 10 Resources.Resolutions.Resolution1.VSyncPulse = 2 Resources.Resolutions.Resolution1.VBackPorch = 33 Resources.Resolutions.Resolution1.HSyncPolarity = N Resources.Resolutions.Resolution1.VSyncPolarity = N Resources.Resolutions.Resolution1.CEAID = 1 Resources.Resolutions.Resolution1.Origin = tvone!done Resources.Resolutions.Resolution1 Resolution Properties 9

10 Custom Resolutions may only be modified, they cannot be created or deleted. If a Custom Resolution is being used on an output and an Attribute (other than the Name) is changed then the resolution will be reapplied on the output and the connection to the output device will be renegotiated. If the Name Attribute is changed the output will revert to the default built-in resolution. A Custom Resolution may be configured by copying the values from a close Built-in (or Custom Resolution). Once you have configured a Custom Resolution use System.SaveAllSettings() to ensure that your changes are persistent and not lost after powering off. Warning: It is possible to apply an invalid Custom Resolution to an output. 10 Resolution Properties

11 Name The option to set a name for this Custom Resolution. Resolution name Resources.Resolutions.Resolution1000.Name The user readable name for this resolution, this should be something meaningful for the user within the limitations of the permissible characters. Resources.Resolutions.Resolution1000.Name = NewCustomResolution Resources.Resolutions.Resolution1000.Name = NewCustomResolution!Done Resources.Resolutions.Resolution1000.Name = NewCustomResolution The default Name is the string EmptyNNNN where NNNN is the number of the Custom Resolution. that Resolution1000 is Empty1000, Resolution1001 is Empty1001, Resolution1009 is Empty1009. Resources.Resolutions.Resolution1000.Name Resources.Resolutions.Resolution1000.Name = Empty1000!Done Resources.Resolutions.Resolution1000.Name The Name attribute has the following limitations: No more than 23 characters Only valid printable ASCII characters may be used. The space character may not be used. There is no checking for duplicate names and if more than one Custom Resolution has the same name then when setting a Custom Resolution of that name to an output the behaviour may not be as expected. If you change the Name attribute of a Custom Resolution that has been set to an output then the output will revert to the default built-in resolution for that output. If you wish that output to use the Custom Resolution it will have to be re-applied. Resolution Properties 11

12 It is possible to set a Custom Resolution that has not be configured to an output. This is intentional. Warning: If you wish to use a Custom Resolution with CORIOgrapher the Name must conform to the following format: <width>x<height><scantype><rate><optional> Where: <width> width in pixels <height> height in pixels x the character x <scantype> only i for interlaced or p for progressive. <rate> the frame rate, this must be at least one character. <optional > optional text. For example the following are valid Name formats for use with CORIOgrapher: 1280x720i40055D 1280x720p6test 1280x720p x720i50 280x72i30 Using CORIOgrapher with a Name that does not conform to the above format may result in unexpected consequences. 12 Resolution Properties

13 Aspect The option to set the Aspect ratio for this Custom Resolution. Used on the CORIOmatrix and CORIOmatrix mini to assist in the signal conversion when an input and the output have different aspect ratio. Resources.Resolutions.Resolution1000.Aspect The aspect ratio for this Custom Resolution in the form: x:y Where x is the width and y is the height in units of equal size. Resources.Resolutions.Resolution1000.Aspect = 16:6 Resources.Resolutions.Resolution1000.Aspect = 16:6!Done Resources.Resolutions.Resolution1000.Aspect = 16:6 4:3 The valid Aspect ratios are: 16:9, 4:3, 5:4, 16:10, 5:3, 1:1, 16:6 Any attempt to set an invalid Aspect ratio will fail. Used on the CORIOmatrix and CORIOmatrix mini only. Not available in the CORIOdiscover Resolution Editor. Resolution Properties 13

14 Can Framelock A read only attribute indicating whether this Custom Resolution is suitable for use with the Framelock feature. Resources.Resolutions.Resolution1000.CanFramelock This attribute indicates whether a Custom Resolution may be used with the Framelock mechanism. Yes No The Custom Resolution is compatible with the Framelock mechanism and may be used as either an Input or and Output to Framelock. The Custom Resolution is not compatible with the Framelock mechanism. Resources.Resolutions.Resolution1000.CanFramelock Resources.Resolutions.Resolution1000.CanFramelock = No!Done Resources.Resolutions.Resolution1000.CanFramelock An Input to Framelock is the source that is to be used as the Framelock reference. An Output to Framelock is to be locked to the reference. Currently this is always No. Not available in the CORIOdiscover Resolution Editor. 14 Resolution Properties

15 Pixel Clock The option to set the Pixel Clock for this Custom Resolution. Pixel Clock Resources.Resolutions.Resolution1000.PixelClock The Pixel Clock value is the speed of the Pixel Clock in pixels per second. The minimum and maximum values are dependent on the following: Where: p = h * v * f p h v f Pixels per second Horizontal Total pixels Vertical Total pixels Frame rate in frames per second For 1920x1080p60: h 2200 v 1125 f 60 Which gives: p = 2200 * 1125 * 60 = 148.5MHz Resolution Properties 15

16 Resources.Resolutions.Resolution1000.PixelClock = Resources.Resolutions.Resolution1000.PixelClock = !Done Resources.Resolutions.Resolution1000.PixelClock = The valid range for the Pixel Clock is 13.5MHz to 162MHz. As the value in Pixels is a function of resolution (including frame rate) then the minimum and maximum value in Pixels varies with the resolution. The minimum Pixel Clock is at 640x480p60 is 800 * 525 * = MHz The maximum Pixel Clock is at 1600x1200p60 is 2160 * 1250 * 60 = 162MHz For interlaced Resolutions the Pixel Clock value will be half the progressive equivalent. In the CORIOdiscover Resolution Editor the Horizontal and Vertical frequencies are derived from the Pixel Clock. 16 Resolution Properties

17 Scan Type The option to whether the scan type for this Custom resolution is to be Interlaced or Progressive. Scan Type Resources.Resolutions.Resolution1000.ScanType The scan type state of this Custom Resolution: p i Progressive scan mode. Interlaced scan mode. Resources.Resolutions.Resolution1000.ScanType = i Resources.Resolutions.Resolution1000.ScanType = i!done Resources.Resolutions.Resolution1000.ScanType = i Progressive ( p ) Only Progressive ( p ) or interlaced ( i ) are valid options. Resolution Properties 17

18 Horizontal Active Pixels The option to set the length of the Horizontal Active Video for this Custom resolution. That is, the width of the displayed image in pixels. Horizontal Active Pixels Resources.Resolutions.Resolution1000.HActive The Horizontal Active Video is the width of the displayed image in pixels. e.g. for a Custom Resolution of 1024x720 this value would be Resources.Resolutions.Resolution1000.HActive = 1024 Resources.Resolutions.Resolution1000.HActive = 1024!Done Resources.Resolutions.Resolution1000.HActive = The valid range of values is 64 to 1920 For a valid Custom Resolution this must be a value in the valid range. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Horizontal Active Pixels. However the Horizontal and Vertical frequency will change. 18 Resolution Properties

19 Horizontal Front Porch The option to set the timing interval for the Horizontal Front Porch for this Custom resolution. Horizontal Front Porch Resources.Resolutions.Resolution1000.HFrontPorch The Horizontal Front Porch is the gap between the end of the Active Video and the start of the Horizontal Sync Pulse in pixels. Resources.Resolutions.Resolution1000.HFrontPorch = 96 Resources.Resolutions.Resolution1000.HFrontPorch = 96!Done Resources.Resolutions.Resolution1000.HFrontPorch = 96 0 The valid range of values is 1 to 2000 For a valid Custom Resolution this must be a value in the valid range. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Horizontal Front Porch. However the Horizontal and Vertical frequency will change. Resolution Properties 19

20 Horizontal Sync Pulse The option to set the length of the Horizontal Sync Pulse for this Custom resolution. Horizontal Sync Pulse Resources.Resolutions.Resolution1000.VSyncPulse The Horizontal Sync Pulse identifies the start of each row of pixels (line of video) in the Custom resolution. Resources.Resolutions.Resolution1000.VSyncPulse = 8 Resources.Resolutions.Resolution1000.VSyncPulse = 8!Done Resources.Resolutions.Resolution1000.VSyncPulse = 8 0 The valid range of values is 8 to 500 For a valid Custom Resolution this must be a value in the valid range. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Horizontal Sync Pulse. However the Horizontal and Vertical frequency will change. 20 Resolution Properties

21 Horizontal Back Porch The option to set the timing interval for the Horizontal Back Porch for this Custom resolution. Horizontal Back Porch Resources.Resolutions.Resolution1000.HBackPorch The Horizontal Back Porch is the gap between the end of the Horizontal Sync Pulse and the beginning of the Active Video in pixels. Resources.Resolutions.Resolution1000.HBackPorch = 288 Resources.Resolutions.Resolution1000.HBackPorch = 288!Done Resources.Resolutions.Resolution1000.HBackPorch = The valid range of values is 1 to 2000 For a valid Custom Resolution this must be a value in the valid range. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Horizontal Back Porch. However the Horizontal and Vertical frequency will change. Resolution Properties 21

22 Horizontal Synchronisation Polarity The option to set the polarity of the Horizontal Sync Pulse for this Custom resolution. Horizontal Synchronisation Polarity Resources.Resolutions.Resolution1000.HSyncPolarity The Horizontal Sync Pulse is a single short pulse which indicates the start of every scan line in the Custom resolution. It may be either Positive or Negative. The values are: P N Positive polarity. Negative polarity. Resources.Resolutions.Resolution1000.HSyncPolarity = N Resources.Resolutions.Resolution1000.HSyncPolarity = N!Done Resources.Resolutions.Resolution1000.HSyncPolarity = N N Only the values N or n for negative and P or p for positive polarity will be accepted. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Horizontal Sync Pulse. However the Horizontal and Vertical frequency will change. 22 Resolution Properties

23 Vertical Active Pixels The option to set the length of the Vertical Active Video for this Custom resolution. That is, the height of the displayed image in pixels (lines). Vertical Active Pixels Resources.Resolutions.Resolution1000.VActive The Vertical Active Video is the height of the displayed image in pixels (lines). e.g. for a Custom Resolution of 1024x720 this value would be 720. Resources.Resolutions.Resolution1000.VActive = 720 Resources.Resolutions.Resolution1000.VActive = 720!Done Resources.Resolutions.Resolution1000.VActive = The valid range of values is 64 to 1200 For a valid Custom Resolution this must be a value in the valid range. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Vertical Active Pixels. However the Vertical frequency will change. Resolution Properties 23

24 Vertical Front Porch The option to set the timing interval for the Vertical Front Porch for this Custom resolution. Vertical Front Porch Resources.Resolutions.Resolution1000.VFrontPorch The Vertical Front Porch is the gap between the end of the Active Video and the start of the Vertical Sync Pulse in pixels. Resources.Resolutions.Resolution1000.VFrontPorch = 3 Resources.Resolutions.Resolution1000.VFrontPorch = 3!Done Resources.Resolutions.Resolution1000.VFrontPorch = 3 0 The valid range of values is 1 to 100. For a valid Custom Resolution this must be a value in the valid range. Interlaced Custom Resolutions require that the Vertical Front Porch is twice the even field, thus a value of 6 will give: Odd field: 3.5 Even field 3 In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Vertical Front Porch. However the Vertical frequency will change. 24 Resolution Properties

25 Vertical Sync Pulse The option to set the length of the Vertical Sync Pulse for this Custom resolution. Vertical Sync Pulse Resources.Resolutions.Resolution1000.VSyncPulse The Vertical Sync Pulse identifies the start of each frame of video in the Custom resolution. that for Interlaced Custom Resolutions both odd and even frames will have a Vertical Sync Pulse. Resources.Resolutions.Resolution1000.VSyncPulse = 2 Resources.Resolutions.Resolution1000.VSyncPulse = 2!Done Resources.Resolutions.Resolution1000.VSyncPulse = 2 0 The valid range of values is 1 to 100. For a valid Custom Resolution this must be a value in the valid range. Interlaced Custom Resolutions require that the Vertical Sync Pulse is twice the even field, thus is a value of 10 will give: Odd field: 5 Even field 5 In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Vertical Sync Pulse. However the Vertical frequency will change. Resolution Properties 25

26 Vertical Back Porch The option to set the timing interval for the Vertical Back Porch for this Custom resolution. Vertical Back Porch Resources.Resolutions.Resolution1000.VBackPorch The Vertical Back Porch is the gap between the end of the Vertical Sync Pulse and the beginning of the Active Video in pixels. Resources.Resolutions.Resolution1000.VBackPorch = 15 Resources.Resolutions.Resolution1000.VBackPorch = 15!Done Resources.Resolutions.Resolution1000.VBackPorch = 15 0 The valid range of values is 1 to 100. For a valid Custom Resolution this must be a value in the valid range. Interlaced Custom Resolutions require that the Vertical Back Porch is twice the even field, thus a value of 69 will give: Odd field: 34 Even field 34.5 In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Vertical Back Porch. However the Vertical frequency will change. 26 Resolution Properties

27 Vertical Synchronisation Polarity The option to set the polarity of the Vertical Sync pulse for this Custom resolution. Vertical Synchronisation Polarity Resources.Resolutions.Resolution1000.VSyncPolarity The Vertical Sync Pulse separates the video fields in the Custom resolution. It may be either Positive or Negative. The values are: P N Positive polarity. Negative polarity. Resources.Resolutions.Resolution1000.VSyncPolarity = N Resources.Resolutions.Resolution1000.VSyncPolarity = N!Done Resources.Resolutions.Resolution1000.VSyncPolarity = N N Only the values N or n for negative and P or p for positive polarity will be accepted. In the CORIOdiscover Resolution Editor the Pixel Clock will not be effected by any changes to the Vertical Sync Pulse. However the Vertical frequency will change. Resolution Properties 27

28 CEAID The option to set the Consumer Electronics Association Digital Television Profile as defined in CEA-861-D. CEAID Resources.Resolutions.Resolution1000.CEAID This attribute is to be used only when creating a Custom Resolution as defined in CEA-861- D. Resources.Resolutions.Resolution1000.CEAID = 0 Resources.Resolutions.Resolution1000.CEAID = 0!Done Resources.Resolutions.Resolution1000.CEAID = or a value specified in the CEA Standard Profile as defined in CEA-861-D. The CEA identifier information option does not affect the Custom Resolution, it is there for providing attached equipment with information on the resolution. Only set this value when defining a Custom Resolution to comply with the CEA Profile for that value. If the Custom Resolution does not confirm to a Profile from CEA-861-D this value must be 0. Warning: If the value is not 0 and the Custom Resolution does conform to the CEA Profile for that value then the result is undefined. 28 Resolution Properties

29 Origin The option to set a string identifying the origin of the Custom Resolution. Resources.Resolutions.Resolution1000.Origin The user readable origin of this resolution, this should be something meaningful for the user within the limitations of the permissible characters. E.g. for a Custom resolution from the CVT list it would be useful to have CVT. For a CEA Standard Profile CEA. Resources.Resolutions.Resolution1000.Origin = Resources.Resolutions.Resolution1000.Origin =!Done Resources.Resolutions.Resolution1000.Origin = The default Origin is an empty, zero length string: Resources.Resolutions.Resolution1000.Origin Resources.Resolutions.Resolution1000.Origin =!Done Resources.Resolutions.Resolution1000.Origin The Origin attribute has the following limitations: No more than 19 characters Only valid printable ASCII characters may be used. The space character may not be used. Not available in the CORIOdiscover Resolution Editor. Resolution Properties 29

30 Line Resolutions are used in the Slot menu for both inputs and outputs by Name. However, it is only possible to set a Resolution on an output. Input Resolutions are read only and are set by the incoming video signal. that if a Custom Resolution and a built-in Resolution are within the selection tolerance then the Custom Resolution will be selected. List of usable Resolutions by Name Get a list of the usable resolutions. Slots.Slot1.Module_Resolutions() List all the usable Resolutions. Slots.Slot16.Module_Resolutions() 640x480p60;4:3; 640x480p72;4:3; <...> 1920x1200p50cvt-rb;16:10; 1920x1200p60cvt-rb;16:10; MyResolution;16:6!Done Slots.Slot16.Module_Resolutions() A list of all the built-in resolutions. For use with input or output modules. 30 Line

31 List of Resolutions by Index (output) Get a list of the resolutions by index. Slots.Slot16.Resolutions Lists all the Resolutions. Slots.Slot16.Resolutions Slots.Slot16.Resolutions.Resolution1 = <...> Slots.Slot16.Resolutions.Resolution2 = <...> <...> Slots.Slot16.Resolutions.Resolution71 = <...> Slots.Slot16.Resolutions.Resolution72 = <...> Slots.Slot16.Resolutions.Resolution1000 = <...> Slots.Slot16.Resolutions.Resolution1001 = <...> <...> Slots.Slot16.Resolutions.Resolution1009 = <...>!Done Slots.Slot16.Resolutions A list of all the resolutions. For use with output modules only. Line 31

32 Resolution by Index (output) Information on a specific Resolution by index. CORIOmax Resolution Editor Programming Guide Slots.Slot16.Resolutions.ResolutionN Where N is the resolution index from 1 to the maximum number of built-in resolutions and 1000 to 1009 for the Custom Resolutions Lists the following attributes of the specified Resolution: Name Aspect CanFramLock For a built-in resolution: Slots.Slot16.Resolutions.Resolution1 Slots.Slot16.Resolutions.Resolution1.Name = 640x480p60 Slots.Slot16.Resolutions.Resolution1.Aspect = 4:3 Slots.Slot16.Resolutions.Resolution1.CanFramelock = No!Done Slots.Slot16.Resolutions.Resolution1 For a Custom Resolution Slots.Slot16.Resolutions.Resolution1000 Slots.Slot16.Resolutions.Resolution1000.Name = MyResolution Slots.Slot16.Resolutions.Resolution1000.Aspect = 4:3 Slots.Slot16.Resolutions.Resolution1000.CanFramelock = No!Done Slots.Slot16.Resolutions.Resolution1000 The configuration of the specified resolution. For use with output modules only. 32 Line

33 Resolution (output) Set the Resolution of an output. Slots.Slot16.out1.Resolution Set the Resolution to be used for an output. Set the resolution: Slots.Slot16.out1.Resolution = Empty1 Slots.Slot16.out1.Resolution = Empty1!Done Slots.Slot16.out1.Resolution = Empty1Read the currently set resolution Slots.Slot16.out1.Resolution Slots.Slot16.out1.Resolution = NewCustomResolution!Done Slots.Slot16.out1.Resolution 1280x720p60 If the properties of the Custom Resolution are changed, then the resolution will be reapplied on the output and the connection to the output device will be renegotiated. If the Name of a Custom Resolution is changed, then the output will return to its default and will need to be set to the new Custom Resolution name. If more than one Custom Resolution has the same name the behaviour is undefined. Custom Resolutions cannot be applied to an SDI output. Line 33

34 Set_Resolution (input) Report the Resolution of the current signal on an input. Slots.Slot1.in1.Set_Resolution Read the currently detected Resolution on the input. Read only. Slots.Slot1.in1.Set_Resolution Slots.Slot1.in1.Set_Resolution = NewCustomResolution!Done Slots.Slot1.in1.Set_Resolution CORIOmax Resolution Editor Programming Guide Not applicable, the behaviour is to show the name of the detected Resolution or nothing if there is no signal. Set_Resolution and Measured_Resolution are identical. If a Custom Resolution and a built-in Resolution are within the selection tolerance then the Custom Resolution will be selected. Custom Resolutions cannot be detected on an SDI input. 34 Line

35 Measured_Resolution (input) Report the Resolution of the current signal on an input. Slots.Slot1.in1.Measured_Resolution Read the currently detected Resolution on the input. Read only. Slots.Slot1.in1.Measured_Resolution Slots.Slot1.in1.Measured_Resolution = NewCustomResolution!Done Slots.Slot1.in1.Measured_Resolution Not applicable, the behaviour is to show the name of the detected Resolution or nothing if there is no signal. If a Custom Resolution and a built-in Resolution are within the selection tolerance then the Custom Resolution will be selected. Measured_Resolution and Set_Resolution are identical. Custom Resolutions cannot be detected on an SDI input. Line 35

36 Modify a Custom Resolution To configure a Custom Resolutions for use access it from the Resources menu. The steps involved in configuring a Custom Resolution for use are: 1. Select one of the Custom Resolutions to use (Resolution1000 to Resolution1099). 2. Give it a meaningful name. 3. Set the rest of the resolution information as appropriate. To edit the Custom Resolution at Resolution1000 (the lowest position for a Custom Resolution) all the attributes must be set: Resources.Resolutions.Resolution1000.Name = MyResolution Resources.Resolutions.Resolution1000.Aspect = 4:3 Resources.Resolutions.Resolution1000.PixelClock = Resources.Resolutions.Resolution1000.ScanType = p Resources.Resolutions.Resolution1000.HActive = 1920 Resources.Resolutions.Resolution1000.HFrontPorch = 96 Resources.Resolutions.Resolution1000.HSyncPulse = 192 Resources.Resolutions.Resolution1000.HBackPorch = 288 Resources.Resolutions.Resolution1000.VActive = 720 Resources.Resolutions.Resolution1000.VFrontPorch = 3 Resources.Resolutions.Resolution1000.VSyncPulse = 10 Resources.Resolutions.Resolution1000.VBackPorch = 15 Resources.Resolutions.Resolution1000.HSyncPolarity = N Resources.Resolutions.Resolution1000.VSyncPolarity = P Resources.Resolutions.Resolution1000.CEAID = 0 Resources.Resolutions.Resolution1000.Origin =, for clarity, only the commands sent to the device are shown above. All responses have been removed. 36 Line

37 Using a Custom Resolution on an Input The Resolution of an input is detected automatically. If a Custom Resolution and a built-in Resolution are within the selection tolerance then the Custom Resolution will be selected. The steps involved in using a Custom Resolution on an input are: 1. Set the Custom Resolution as described above. 2. Connect a source that has the signal as described in a Custom Resolution. 3. Check that the Custom Resolution is detected correctly with either Measured_Resolution or Set_Resolution. Slots.Slot1.in1.Measured_Resolution Slots.Slot1.in1.Measured_Resolution = MyResolution!Done Slots.Slot1.in1.Measured_Resolution Configure an Output to use a Custom Resolution The Resolution used by an output is set using the Resolution attribute, see List of usable Resolutions by Name above. The steps involved in using a Custom Resolution on an output are: 1. Set the Custom Resolution as described above. 2. Connect a display that supports the signal as described in a Custom Resolution. 3. Set the Custom Resolution into the desired slot and output. Slots.Slot16.out2.Resolution = MyResolution Slots.Slot16.out2.Resolution = MyResolution!Done Slots.Slot16.out2.Resolution = MyResolution Line 37

38 CORIOdiscover Resolution Editor From version 1.1 the CORIOdiscover application has support for editing Custom Resolutions. Start the CORIOdiscover application: Select the device to have the Custom Resolution and press the Resolution Editor button. This will prompt you for the administration username and password before allowing you to modify the system at this level. Once you have successfully logged in you will be presented with the Resolution Editor main window: By default all the Resolutions, built-in and custom, are shown. To see the Custom Resolutions you may scroll to the bottom of the list or select the custom only radio button: 38 CORIOdiscover Resolution Editor

39 As can be seen from the above images the built-in resolutions have only a Copy button, whereas the Custom Resolution fields have Copy, Edit and Reset buttons. CORIOdiscover Resolution Editor 39

40 Creating a Custom Resolution based on a built-in resolution A simple way to create a Custom Resolution is to base it on an existing built-in resolution. 1. Select the built-in resolution closest to the desired resolution. 2. Press on the Copy button, the Copy Resolution screen will appear: 3. Enter a meaningful name 1 for your Custom Resolution and change the other fields as required. For more information on the individual fields see the There are a number of standard video resolutions built-in to the CORIOmax (CORIOmaster, CORIOmaster mini, CORIOmatrix and CORIOmatrix mini) products. In addition there are 10 Custom Resolutions configurable by the user. These Custom Resolutions may be configured either from CORIOdiscover or the Line section on page 6 above. 4. Select the Update button and the new Custom Resolution will be placed in the next empty Custom Resolution. 1 Warning: If you wish to use a Custom Resolution with CORIOgrapher the Name must conform to the format described in the Name section on page CORIOdiscover Resolution Editor

41 Creating a Custom Resolution based on a standard To create a Custom Resolution based on a video standard (such as CVT). 1. Select an empty Custom Resolution. 2. Press on the Edit button. 3. Select the required standard from the Standard drop down list: 4. Select the required resolution from the Resolutions drop down list: 5. Enter a meaningful name 2 for your Custom Resolution and change the other fields as required. For more information on the individual fields see the Properties section on page 9 above. 6. Select the Update button to save your new Custom resolution. 2 Warning: If you wish to use a Custom Resolution with CORIOgrapher the Name must conform to the format described in the Name section on page 11. CORIOdiscover Resolution Editor 41

42 Creating a Custom Resolution from scratch To create a Custom Resolution not based on a video standard. CORIOmax Resolution Editor Programming Guide 1. Select an empty Custom Resolution. 2. Press on the Edit button. 3. Select Manually create a custom resolution from the drop down list 4. Enter a meaningful name 3 for your Custom Resolution and change the other fields as required. For more information on the individual fields see the Properties section on page 9 aboveabove. 5. Select the Update button to save your new Custom resolution. 3 Warning: If you wish to use a Custom Resolution with CORIOgrapher the Name must conform to the format described in the Name section on page CORIOdiscover Resolution Editor

43 Editing an existing Custom Resolution To edit a Custom Resolution. 1. Select the Custom Resolution to change. 2. Press on the Edit button. 3. Make the required changes. For more information on the individual fields see the Properties section on page 9 above. 4. Click on the Update button to save the changes. If the Custom Resolution is active on an output the changes will take effect immediately upon pressing the Update button with the exception of the Name. that if you change the Name of a Custom Resolution that has been set to an output then the output will revert to the default built-in resolution for that output. If you wish that output to use the Custom Resolution it will have to be re-applied. Warning: Changes may result in Resolution that cannot be displayed. Clearing an existing Custom Resolution To clear a Custom Resolution and return it to its default values. 1. Select the Custom Resolution to clear. 2. Press on the Reset button. 3. In the Reset the Resolution dialog box press on the Yes button. 4. The Custom Resolution will now be cleared and returned to its default values. that if an output has been configured to use the Custom Resolution, that output will revert to its default built-in resolution. CORIOdiscover Resolution Editor 43