Skip to main content

DCV/XVCapture Command Line Parameters

Michael Satterfield
Updated

Overview

The Apteryx Imaging applications support multiple command line options for opening patients from the standard application command line. The XrayVision DCV (DCV) filename is "XrayVisionDCV.exe" while the XVCapture (XVC) is "XVCapture.exe".

Example: "XrayVisionDCV.exe"/b"Doe, John::123-45-6789::123456::5/1/1970::M"

 

Sections:

  • Registry Entries
  • Command Line Flag Formatting
  • Flags Specifying Multiple Sets of Data
  • Command Line Flags
  • Command Line Grammar

Registry Entries

For partners looking to integrate via launching and passing command line parameters, the following registry path can be used to determine XVCapture/DCV installation location.

Key for 64-bit OS:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apteryx\ApplicationFullPaths

Key for 32-bit OS:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Apteryx\ApplicationFullPaths

Value Name:

DCV Client Application

Value Type:

Reg_SZ/String Value

Value Date (Example):

C:\Apteryx\XVCapture\XVCapture.exe

 

For manual installers of XVCapture/DCV it is recommended to ensure all of the typical paths (see below) exist during configuration. These paths are ONLY written/overwritten when XVCapture/DCV is launched as administrator, and in fact running it as administrator is a recommended quick way to write the recommended paths.

 

For scripting a consistent installation of XVCapture/DCV it is recommended to write all of the below keys/values to the registry as if the program was ran as administrator to ensure all edge cases are covered.

An example of all keys & values written when XVCapture/DCV is ran as administrator on a 64-bit OS:

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apteryx\ApplicationFullPaths]
"XVCapture"="C:\\Apteryx\XVCapture\XVCapture\XVCapture.exe"
"DCV Client Application"="C:\\Apteryx\XVCapture\XVCapture\XVCapture.exe"

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apteryx\ApplicationLocations]
"XVCapture"="C:\\Apteryx\XVCapture\XVCapture"
"DCV Client Application"="C:\\Apteryx\XVCapture\XVCapture"

An example of all keys & values written when XVCapture/DCV is ran as administrator on a 32-bit OS:

[HKEY_LOCAL_MACHINE\SOFTWARE\Apteryx\ApplicationFullPaths]
"XVCapture"="C:\\Apteryx\XVCapture\XVCapture\XVCapture.exe"
"DCV Client Application"="C:\\Apteryx\XVCapture\XVCapture\XVCapture.exe"

[HKEY_LOCAL_MACHINE\SOFTWARE\Apteryx\ApplicationLocations]
"XVCapture"="C:\\Apteryx\XVCapture\XVCapture"
"DCV Client Application"="C:\\Apteryx\XVCapture\XVCapture"

Command Line Flags Formatting

Command line flags are preceded by either a '-' or a '/' and indicate that the specified type of data is to follow the flag.

Example: "XrayVisionDCV.exe"-p"lastname,firstname"

Example: "XrayVisionDCV.exe"/p"lastname, firstname"

Flags Specifying Multiple Sets of Data

Flags such as the ‘P’ flag require the specification of multiple sets of patient demographic information. Usually, this data is separated by one or more delimiters (e.g. “::”). Flags that contain multiple sets of data should be placed within double quotes.

The format for specify the patient demographic information is as follows.Any of the various segments of data can be omitted. Current valid values for the Species are: Human; Feline; Equine; Ovine; Porcine; Caprine; Canine; and Bovine.

Lastname, Firstname::Primary ID Number::Other ID Number::Birth Date::Sex::Species::Breed

Example: "XrayVisionDCV.exe" /p"lastname,firstname::123-45-6789::123456::5/1/1970::M"
Example: "XrayVisionDCV.exe" /p"lastname, firstname::::123456::5/1/1970::M"
Example: "XrayVisionDCV.exe" /p"::12341234::::::"
Example: "XrayVisionDCV.exe" /p"::12341234" (no name, only an ID number)

Command Line Flags

b -or- B (View Patient Images)

Specifies a patient to bridge to the image query screen. This option willautomatically take the user to the image query screen.

The format of this parameter is identical to the “p” command.

Example: "XrayVisionDCV.exe" /b"lastname,firstname::123-45-6789::123456::5/1/1970::M"

Other example formats can be found under the “p” command description.

batchcommands -OR- BATCHCOMMANDS

This option instructs DCV to process a list of command line options are saved in the specified file. The parameter has the following format: /batchcommands"batch_filename;event_name;target_results_filename". Upon success or error, the event specified by event_name will be signaled. Once the event_name has been triggered, the target_results_filename will contain the results or error of the process.

The batch_filename is the fully qualified path to a text file that contains the sequence of instructions / command line options that should be performed. Comment lines begin with ';' character.

Following is an example of a batch file:

/pfl"lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo1.DAT"
/pfl"lastname, firstname::::123456::5/1/1970;MyEvent;C:\ImageInfo2.DAT"
/pfl"lastname, firstname::123-45-6789::::5/1/1970;MyEvent;C:\ImageInfo3.DAT"
/querydicomserver “DicomServer1;30” /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo4.DAT"
/querylocal /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /batchcommands"C:\SomePath\BatchCommands.TXT;MyEvent;C:\Results.DAT"

bridgedcapture -OR- BRIDGEDCAPTURE (BRIDGED IMAGE CAPTURE)

This option indicates DCV should perform a bridged image capture. While similar to the “c” command line option, this option works completely through the capture process and can return focus back to the invoking application.
The parameter has the following format: /bridgedcapture"patient_name::ss_number::id_number::date_of_birth::sex::species::breed;
event_name;target_results_filename;target_capture_mode;keep_DCV_in_foreground".

  • The patient identifying information is the same as the other parameters (i.e. /p).
  • Upon success or error, the event specified by “event_name” will be signaled.
  • The “target_results_filename” will contain the results of the operation. A status of “Success” will indicate images were successfully acquired. All other text indicates the error message associated with the acquisition. Note that you can leave this field blank.
  • The “target_capture_mode” indicates what type of image is supposed to be acquired. Possible values for this parameter are:
    • <blank> - This will cause DCV to prompt the user to select what should be acquired. This is the same behavior as leaving the “Modality/Progression” field blank when capturing images in DCV.
    • “Progression” – Setting this field to the word “Progression” will prompt DCV to have the user select a progression to use during acquisition. This progression is then automatically used to acquire images.
    • A DICOM modality (e.g. “IO”, “PX”, “DX”, etc) – Setting this field to a DICOM modality will cause DCV to automatically proceed with acquiring images from a device supporting the indicated modality (for example, a value of “IO” will cause DCV to automatically select the hardware that supports the IO modality). Note that if more than one hardware extension is installed that supports a modality, then the user will be prompted to select the appropriate hardware.
    • A progression name (e.g. “4 Bite Wing Series”, “FMX #18”, etc). – Setting this field to a specific progression name will cause DCV to automatically proceed with acquiring images using the specified progression. Note that if more than one hardware extension is installed that supports the associated modality, then the user will be prompted to select the appropriate hardware.
    • A capture script name (e.g. “PX, DX and XC Exam”, etc). – Setting this field to a specific capture script name will cause DCV to automatically proceed with acquiring images using the specified capture script.
    • An IXDLL filename (e.g. “Simulator.IXDLL”, etc). – Setting this field to a specific simulator name will cause DCV to automatically proceed with acquiring images using the specified IXDLL.
  • The “keep_DCV_in_foreground” parameter indicates if DCV should be left as the foreground windows after the acquisition interaction with the program has been completed. Setting this value to “true” will leave DCV active after the acquisition. A value of “false” will minimize DCV after the interaction has completed.

Please note that only v3.4.0.23 and higher support this command line parameter.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;IO;true"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;Progression;false"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;4 Bite Wing Series;false"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT; PX, DX and XC Exam;false"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;Simulator.IXDLL;false"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /bridgedcapture "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;Simulator Simulated X-ray;false"

c -or- C (Capture Patient Images)

Specifies a patient to bridge to the worklist query screen. This option will automatically take the user to the worklist query screen.

The format of this parameter is identical to the “p” command.

Example: "XrayVisionDCV.exe" /c"lastname,firstname::123-45-6789::123456::5/1/1970::M"

Other example formats can be found under the “p” command description.

convert -or- CONVERT (Convert Image File)

This option instructs DCV to convert the specified file into JPEG. The parameter has the following format: /convert "source_filename;target_filename;error_msg_filename;event_name;maximum_dimensions;JPEGQuality".

Please note that only v3.4.0.17 and higher support this command line parameter.

The source_filename does not have to be located in a DCV imaging directory. The converted image will be saved in the JPEG format to the file specified by target_filename. This conversion works for all files types supported by DCV. If an error occurs the error message will be saved into the file specified by error_msg_filename (upon successful operation, this file will contain the text "Success"). Upon success or error, the event specified by event_name will be signaled. Note that if the source image contains multiple images, only the first image will be extracted. Note that if the image you are converting from is a DICOM file, a XML file containing the DICOM information will also be generated. The maximum_dimensions parameter is optional and can be used to specify the maximum dimensions that should be used for the exported image (e.g. 800x600). This parameter accepts a wide range of formats including: “800x600”, “800,600”, “800/600”, “800:600”. You can additionally specify the following keywords for the maximum_dimensions: “stamp” (equal to 256x256); “small” (equal to 128x128); “medium” (equal to 512x512); “large” (equal to 1024x1024). The JPEGQuality parameter is additional optional and can be used to specify the JPEG quality that should be used (default is 100). Valid values for this parameter are 1 (lowest quality) to 100 (highest quality).

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /convert”C:\SomePath\SomeFilename.DIC;C:\SomePath\ConvertedImage.JPG;C:\SomePath\ConvertedMessage.TXT;MyEvent"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /convert”C:\SomePath\SomeFilename.DIC;C:\SomePath\ConvertedImage.JPG;C:\SomePath\ConvertedMessage.TXT;MyEvent;800x600"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /convert”C:\SomePath\SomeFilename.DIC;C:\SomePath\ConvertedImage.JPG;C:\SomePath\ConvertedMessage.TXT;MyEvent;stamp"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /convert”C:\SomePath\SomeFilename.DIC;C:\SomePath\ConvertedImage.JPG;C:\SomePath\ConvertedMessage.TXT;MyEvent;;50"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /convert”C:\SomePath\SomeFilename.DIC;C:\SomePath\ConvertedImage.JPG;C:\SomePath\ConvertedMessage.TXT;MyEvent;800x600;75"

db -or- DB (Add Patient To Database)

Adds a patient to the patient database (the patient drop-down list). This option does not change the current screen displayed in the DCV program.

The format of this parameter is identical to the “p” command.

Example: "XrayVisionDCV.exe" /db"lastname,firstname::123-45-6789::123456::5/1/1970::M"

Other example formats can be found under the “p” command description.

display –or– DISPLAY (Display study, series or image)

This option instructs DCV to display a specific study, series or image. The parameter has the following format: /display "studyUID::seriesUID::sopinstanceUID".

Please note that only v3.5.0.1 and higher support this command line parameter.

Note that this command line option will only display images that are currently in the local database. If necessary, images can be saved to the local database before invoking this command by using one of the “query” commands. The studyUID parameter identifies the Study UID of the image or group of images that is to be displayed and is required (i.e. must be specified). The seriesUID specifies the specific series of images that is to be display and can be left blank (or not specified) to display all the images in the specified Study UID. The sopinstanceUID specifies the specific image that is to be display and can be left blank (or not specified) to display all the images in the specified Study UID or Series UID. Note that if any of the UIDs are invalid or not found, nothing happens.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /display”1.2.3.4.5.6.7.8"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /display”1.2.3.4.5.6.7.8::1.2.3.4.5.6.7.8.1"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /display”1.2.3.4.5.6.7.8::1.2.3.4.5.6.7.8.1::1.2.3.4.5.6.7.8.1.1"

f -or- F (Patient File Specification)

A file containing the patient specification. The format of the file is first_name, last_name, ss_number, id_number, date_of_birth, sex where each item is separated by a new-line. Any of the patient items can be left blank.

Example: "C:\Program Files\Apteryx\XrayVisionDCV" /f"C:\PatientSpecification.TXT"

forwardnow –or– FORWARDNOW (Forward Images Now)

This option indicates that DCV should be forward any images in its ToStore database as soon as the application starts (or is invoked). Please note that processing of this command option will block the operation and startup of DCV until it has finished processing any images in its ToStore database. Note that this option will additionally record to the audit trail if it has been enabled. If the audit trail is enabled and the event cannot be recorded, then DCV will not forward images.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /forwardnow

h –or– H (Hide DCV)

This option indicates that DCV should be hidden when it is invoked (e.g. it starts minimized if it is not currently running; it is not brought to the foreground if it is already running). Note that this command will not work if it is specified in a batch file command list. Also note, that if you are specifying other commands that provide patient demographic information, you need to specify this command line option first.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /h
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /h /p""lastname, firstname::123-45-6789::123456::5/1/1970

import –or– IMPORT (Import Images)

This option instructs DCV to import one or more files into the database. The parameter has the following format: /import "source_path;filespec_or_filename;add_to_ToStore;touch_up_files;results_filename;event_name".

Please note that only v3.5.0.1 and higher support this command line parameter.

Also note that this functionality will only import DICOM files and will skip any other files that may match the filespec_or_filename. The source_path parameter indicates the path containing the files that are to be imported. The filespec_or_filename parameter specifies the wildcarded file specification (e.g. "*.*", "*.DCM") that identifies the files to be imported or a specific filename. The add_to_ToStore parameter (either "true" or "false"; default is "true" if not specified) indicates whether or not the imported images should be added to the list of image that are to be forwarded on to other DICOM servers. The touch_up_files parameter (either "true" or "false"; default is "true" if not specified) indicates whether or not the imported images should be touched up as they are imported or if they should be imported as is. If they are touched up, then the compression will be updated according to the DCV preferences and other data integrity checks and data correction will be performed. The results of the import will be put into the file specified by results_filename if specified. Upon success or error, the event specified by event_name will be signaled.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /import ”C:\SomePath;*.*;true;true;C:\SomePath\Results.TXT;MyEvent"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /import C:\SomePath;*.DCM;;;C:\SomePath\Results.TXT;MyEvent"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /import C:\SomePath;Specificfile.DIC;false,true"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /import C:\SomePath;*.*"

p -or- P (Patient Specification)

Specifies a patient to bridge to the image or worklist query screen. The bridging option (viewing or capturing) behavior is defined under the “Command Line Support” option under the “Data Entry Options”. This option will automatically take the user to the specified screen.
Each item in the patient specification is separated by a set of double colons “::”. The format of the specification is “patient_name::id_number::other_id_number::date_of_birth::sex::species::breed”. DCV will strip all punctuation from the various ID numbers. The “date_of_birth” field is a string format of the date and may be specified in any form (e.g."5/23/99", "5-23-99","May 23, 1999", "23 May 1999"). The “sex” field is a string format and maybe specified in any form (e.g. "M", "Male"). All fields are optional and do not have to be specified. The “species” and “breed” parameters are ignored if the DCV program is not set to one of the veterinary modes.

Example: "XrayVisionDCV.exe" /p"lastname,firstname::123-45-6789::123456::5/1/1970::M"
Example: "XrayVisionDCV.exe" /p"lastname,firstname::::123456::5/1/1970::M"
Example: "XrayVisionDCV.exe" /p"lastname,firstname::123-45-6789::::5/1/1970::M"
Example: "XrayVisionDCV.exe" /p"lastname,firstname::123-45-6789::123456"
Example: "XrayVisionDCV.exe" /p"lastname,firstname::::::::::canine"
Example: "XrayVisionDCV.exe" /p"lastname,firstname::123-45-6789::::5/1/1970::M::feline"

pfl -or- PFL -or- patientfilelist -or- PATIENTFILELIST  (Get Patient File List)

This option instructs DCV to save a list of patient files to a specified file. The parameter has the following format: /pfl"patient_name::ss_number::id_number::date_of_birth::sex::species::breed;event_name;target_filename;image_restriction". The patient identifying information is the same as the other parameters (i.e. /p).

Please note that only v3.4.0.17 and higher support this command line parameter.

In the returned information, TEETH is a hexadecimal value indicating the adult teeth that are specified with each file; the least-significant-bit refers to tooth #1. DTEETH is a hexadecimal value indicating the deciduous teeth that are specified with each file; the least-significant-bit refers to tooth letter A.

The image_restriction parameter is optional and can be used to limit what images are returned. “all” will return all images for the specified patient. “newest” or “latest” will return only the newest image(s) for each modality type (note that all images in the same series will be returned if it is the newest set of image). “<number>” specifies a number of days old to include. For example, if “90” is specified, only those images acquired in the past 90 days will be included.

Following is an example of an output file:

C:\SomePath\File1.DIC;TEETH(00000007);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(IO)
C:\SomePath\File2.DIC;TEETH(FFFFFFFF);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(PX)
C:\SomePath\File3.DIC;TEETH(00000180);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(IO)

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::::5/1/1970;MyEvent;C:\ImageInfo.DAT"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::::5/1/1970;MyEvent;C:\ImageInfo.DAT;newest"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::::5/1/1970;MyEvent;C:\ImageInfo.DAT;365"

querydicom -OR- QUERYDICOM (QUERY DICOM SERVER)

This option instructs DCV to query the local database and DICOM servers for the other command line options that query and retrieve information (e.g. “PFL”, “E”, and “T” options). This option queries all enabled DICOM servers in the DCV DICOM Server preferences. Note that this command must be specified before the other query/retrieve command line options that should be affected by it.
The parameter has the following format: /querydicom "Number_of_days". The “Number_of_days” parameter indicates how many days of images to retrieve during the DICOM query. A value of “0” indicates to retrieve all images for the patient.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /querydicom “30” /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT" /querydicom “30” /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"

In this example, the first “PFL” command will query from the local database (the default behavior) while the second “PFL” command will query from the local database and the various DICOM servers.

querydicomserver -OR- QUERYDICOMSERVER (QUERY DICOM SERVER)

This option instructs DCV to query the local database and a DICOM server for the other command line options that query and retrieve information (e.g. “PFL”, “E”, and “T” options). This option queries the server with the indicated nickname (DICOM server definitions can be found in the DCV DICOM Server preferences). Note that this command must be specified before the other query/retrieve command line options that should be affected by it.

The parameter has the following format: /querydicom "Server_Nickname;Number_of_days". The “Server_Nickname” parameter indicates the nickname of the DICOM server that can be found in the DCV DICOM Server preferences. The “Number_of_days” parameter indicates how many days of images to retrieve during the DICOM query. A value of “0” indicates to retrieve all images for the patient. Please note that server names are case sensitive.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /querydicomserver “DicomServer1;30” /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"

querylocal -OR- QUERYLOCAL (QUERY LOCAL DATABASE)

This option instructs DCV to only query the local database for the other command line options that query and retrieve information (e.g. “PFL”, “E”, and “T” options). This is the default behavior of the various query and retrieve command line options. This option should be specified if you are mixing queries from local databases and DICOM queries (in other words doing one query using DICOM servers and the next that should only query locally). Note that this command must be specified before the other query/retrieve command line options that should be affected by it.
This parameter is a standalone option.

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /querylocal /pfl "lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT"

s -or- S (Specify Patient)

Specifies a patient to bridge to either the image or worklist query screen.The program records which patient has been specified on the command line and then automatically fills in the information the next time the user goes to the image query or worklist query screen. This option does not change the current screen displayed in the DCV program.

The format of this parameter is identical to the “p” command.

Example: "XrayVisionDCV.exe" /s"lastname,firstname::123-45-6789::123456::5/1/1970::M"

Other example formats can be found under the “p” command description.

t -OR- T (GET TOOTH INFORMATION)

This option instructs DCV to saving patient and tooth related information to a specified file. The parameter has the following format: /t"patient_name::ss_number::id_number::date_of_birth;event_name;target_filename; specification_type;specification_data". The patient identifying information is the same as the other parameters (i.e. /p). The specification_type indicates what information is being supplied to identify which images to retrieve: TEETH; DTEETH; UNASSOCIATED; or ALL. TEETH indicates that specification_data is a hexadecimal value indicating the adult teeth where the least-significant-bit refers to tooth #1. DTEETH indicates that specification_data is a hexadecimal value indicating the deciduous teeth where the least-significant-bit refers to tooth letter A. UNASSOCIATED indicates that images with no associated teeth should be returned (specification_data is ignored). ALL indicates that images for all teeth should be returned. If the patient does not exist, the patient is NOT created, nothing is displayed, nothing is done with the target file and the event is triggered. The target_filename is the file where the image data will be stored and is stored in text format of the form:

Full_filename_and_path1;TEETH(xxxxx);DTEETH(yyyyy);TAKEN(YYYY/MM/DD);MODALITY(mm)
Full_filename_and_path2;TEETH(xxxxx);DTEETH(yyyyy);TAKEN(YYYY/MM/DD) ;MODALITY(mm)
...

Following is an example of an output file:

C:\SomePath\File1.DIC;TEETH(00000007);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(IO)
C:\SomePath\File2.DIC;TEETH(FFFFFFFF);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(PX)
C:\SomePath\File3.DIC;TEETH(00000180);DTEETH(00000000);TAKEN(2005/12/01);MODALITY(IO)

Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;TEETH;00012AB3"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::::123456::5/1/1970;MyEvent;C:\ImageInfo.DAT;DTEETH;00001111"
Example: "C:\Program Files\Apteryx\XrayVisionDCV.exe" /t"lastname, firstname::123-45-6789::::5/1/1970;MyEvent;C:\ImageInfo.DAT;ALL;0"

UIDDIAGNOSTICS (UID DIAGNOSTICS)

A diagnostic report that matches missing UID's to patient info in the database. To be performed by qualified technicians only. The format of the file is DatabasePath; UID_List_Filename; Results_Filename.

Example: "C:\Program Files\Apteryx\XrayVisionDCV" /f"C:\PatientSpecification.TXT"

v -or- V (View Patient Images)

Specifies a patient to bridge to the viewing query screen. This option will automatically take the user to the image query screen.

The format of this parameter is identical to the “p” command.

Example: "XrayVisionDCV.exe" /v"lastname,firstname::123-45-6789::123456::5/1/1970::M"

Other example formats can be found under the “p” command description.

Command Line Grammar

<program name> { filename | ('-'|'/')op[space]value }
op: b | B | c | C | db | DB |p | P | v | V | s | S
space: ' '
value: "string" | string

 

Article Version 1.0 08-03-2026