Setting DPX header values with RVIO

RVIO 3.10.11 and onward is capable of setting most of the DPX header values
from the command line manually. In addition RVIO will set some header
values (those related to color) automatically if it can. 

Set the project header value:

 rvio in.#.exr -o out.#.dpx -outparams "project=THE PROJECT"

Set colorspace header values:

 rvio in.#.exr -o out.#.dpx -outparams transfer=LINEAR colorimetric=REC709

 

RVIO will insert the  header values automatically when -out709, -outlog, or -outpa are used.

This is the complete list of output parameters:

transfer Transfer function (LOG, DENSITY, REC709, USER, VIDEO, SMPTE274M, REC601-625, REC601-525, NTSC, PAL, or number)
colorimetric Colorimetric specification (REC709, USER, VIDEO, SMPTE274M, REC601-625, REC601-525, NTSC, PAL, or number)
creator ASCII string
copyright ASCII string
project ASCII string
orientation Pixel Origin string or int (TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT, ROTATED_TOP_LEFT, ROTATED_TOP_RIGHT, ROTATED_BOTTOM_LEFT, ROTATED_BOTTOM_RIGHT)
create_time ISO 8601 ASCII string: YYYY:MM:DD:hh:mm:ssTZ 
film/mfg_id 2 digit manufacturer ID edge code
film/type 2 digit film type edge code
film/offset 2 digit film offset in perfs edge code
film/prefix 6 digit film prefix edge code
film/count 4 digit film count edge code
film/format 32 char film format (e.g. Academy)
film/frame_position Frame position in sequence
film/sequence_len Sequence length
film/frame_rate Frame rate (frames per second)
film/shutter_angle Shutter angle in degrees
film/frame_id 32 character frame identification
film/slate_info 100 character slate info
tv/time_code SMPTE time code
tv/user_bits SMPTE user bits
tv/interlace Interlace (0=no, 1=2:1)
tv/field_num Field number
tv/video_signal Video signal standard 0-254 (see DPX spec)
tv/horizontal_sample_rate Horizontal sampling rate in Hz
tv/vertical_sample_rate Vertical sampling rate in Hz
tv/frame_rate Temporal sampling rate or frame rate in Hz
tv/time_offset Time offset from sync to first pixel in ms
tv/gamma Gamma
tv/black_level Black level
tv/black_gain Black gain
tv/break_point Breakpoint
tv/white_level White level
tv/integration_times Integration times
source/x_offset X offset
source/y_offset X offset
source/x_center X center
source/y_center Y center
source/x_original_size X original size
source/y_original_size Y original size
source/file_name Source file name
source/creation_time Source creation time YYYY:MM:DD:hh:mm:ssTZ
source/input_dev Input device name
source/input_dev Input device serial number
source/border_XL Border validity left
source/border_XR Border validity right
source/border_YT Border validity top
source/border_YB Border validity bottom
source/pixel_aspect_H Pixel aspect ratio horizonal component
source/pixel_aspect_V Pixel aspect ratio vertical component

Follow

6 Comments

  • 0
    Avatar
    Viet Nguyen

    Can RVIO be used to change DPX metadata without affecting the image data?

    It appears that if I go from one DPX to another adding output params I get a slightly different image. 

  • 0
    Avatar
    Jim Hourihan

    It depends on the bit depth and colorspace of the incoming image. RVIO will rerender the pixels so there's a possibility that some color aliasing or rounding could occur. It also depends on which binary (rvio or rvio_hw) you're using. We currently don't have a method of writing just the header but we've considered it esp because of the way nuke writes DPX files (i.e. not possible to surmise the colorspace based on combinations of header values). 

    Can you tell us a bit more about the input image? Bit depth, colorspace, etc, etc?

        -Jim

  • 0
    Avatar
    jean-francois boivin

    Hi,

    I'm having trouble converting dpx to exr images with rvio.

    When I use this command:

    rvio image.1-30@@@@@@@.dpx -o C:\Temp\test\left.@@@@@@@.exr

    I get "empty" exr. All black images.

    But when i use this command:

    rvio_hw image.1-30@@@@@@@.dpx -o C:\Temp\test\left.@@@@@@@.exr

    Everything seems fine.

    Is there a reason?

    Also, can you explain me what's the difference between "rvio" and "rvio_hw".

    Thanks

    Jeff

  • 0
    Avatar
    Jon Morley

    Hi jeff,

    The difference between "rvio_hw" and "rvio" is that "rvio_hw" ("hw" stands for hardware) requires a graphics card to do its conversions while "rvio" emulates the hardware in software and approximates the results. Occasionally there are discrepancies between the actual hardware output and the simulated. It is possible you have found one within the version you are using.

     

    Can you describe what version you are using and on what operating system?

     

    Also, it is very helpful to post the results of running "rvls -x" on one of your source images as that discloses the metadata in the files which "rvio" relies on.

     

    Thanks,

    Jon

  • 0
    Avatar
    jean-francois boivin

    Hi Jon,

    I got the version 3.12.13 in 32bits and the version 3.12.12 in 64bits.

    It's on Windows7 64bits.

    Here are the results of rvls -x.

    DPX:

    Resolution   5120 x 2700, 3ch, 8 bits/ch

    Channels                       

    ChannelsInFile   3                        

    DPX/Version   V1.0                     

    DPX/CreateTime   2011:10:20:12:03:43:Pac                        

    DPX/Creator   Pablo                     

    DPX/DataOffset   2097152             

    DPX-Source/InputDevice   A006_L001_1007IS                    

    DPX/Orientation   Top Left   

    DPX-Source/HorizontalPixelAspect   1     

    DPX-Source/VerticalPixelAspect   1                   

    DPX-0/Descriptor   RGB                 

    DPX-0/Colorimetric   Linear                     

    DPX-0/Transfer   Linear                        

    DPX/BitSize   10                      

    DPX-0/Packing   LSB Padded                    

    DPX-TV/UserBits   00:00:00:00                    

    DPX-TV/TimeCode   01:02:06:06                   

    PixelAspectRatio   1                   

    DPX/userDataSize   -1

    EXR : (Black image) with RVIO

    Resolution   5120 x 2700, 4ch, 16 bits/ch floating point                 

    Channels           

    PixelAspectRatio   1    

    EXR/screenWindowWidth   1   

    EXR/screenWindowCenter   (0 0)     

    EXR/pixelAspectRatio   1            

    EXR/lineOrder   INCREASING_Y        

    EXR/displayWindow   (0 0) - (5119 2699)           

    EXR/dataWindow   (0 0) - (5119 2699)          

    EXR/compression   PIZ_COMPRESSION      

    ColorSpace/Transfer   Linear     

    ColorSpace/Primaries   Rec709

    EXR (Working) with RVIO_HW:

    Resolution   5120 x 2700, 4ch, 16 bits/ch floating point                 

    Channels           

    PixelAspectRatio   1    

    EXR/screenWindowWidth   1   

    EXR/screenWindowCenter   (0 0)     

    EXR/pixelAspectRatio   1            

    EXR/lineOrder   INCREASING_Y        

    EXR/displayWindow   (0 0) - (5119 2699)           

    EXR/dataWindow   (0 0) - (5119 2699)          

    EXR/compression   PIZ_COMPRESSION      

    ColorSpace/Transfer   Linear     

    ColorSpace/Primaries   Rec709

    It's the same result with 32bits and 64bits version of RVIO. (Back image, only informations).

    Thanks!

  • 0
    Avatar
    Jon Morley

    Hi Jeff,

    I am going to move this one into a support ticket to discuss further.

    Thanks,

    Jon

Please sign in to leave a comment.