Resource Management Tool Version 1.0.2 User's Guide
Preface
Please read this manual thoroughly before operating this software to familiarize yourself with its capabilities and to make the most of its many functions.
About This Manual
Symbols Used in This Manual
The following symbols are used in this manual to explain procedures and restrictions.
IMPORTANTIndicates operational requirements and restrictions. Be sure to read these items carefully to operate the product correctly, and avoid damage to the product or property.
NOTEIndicates a clarification of an operation, or contains additional explanations for a procedure. Reading these notes is highly recommended.
Abbreviations Used in This Document
This manual uses the following abbreviations.
Microsoft Windows operating system: Windows
Microsoft .NET Framework: .NET Framework
Terms Used in This Document
The term "this software" refers to Font Manager or Color Manager.
The term "device" refers to multi functional peripherals and printers.
Trademarks
All brand names and product names appearing on this document are registered trademarks or trademarks of their respective owners.
All other trademarks are the property of their respective owners.
Copyright
© CANON INC. 2024
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without the prior written permission of Canon Inc.
Disclaimers
The information in this document is subject to change without notice.
CANON INC. MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, EITHER EXPRESS OR IMPLIED, EXCEPT AS PROVIDED HEREIN, INCLUDING WITHOUT LIMITATION, THEREOF, WARRANTIES AS TO MARKETABILITY, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OF USE OR NON-INFRINGEMENT. CANON INC. SHALL NOT BE LIABLE FOR ANY DIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY NATURE, OR LOSSES OR EXPENSES RESULTING FROM THE USE OF THIS MATERIAL.
Before Using This Product
This section describes an overview of this software.
This Software
This software is a console application that manages the fonts/macros of devices as ICC profiles. This software is used in the command line.
The following two applications are provided.
Font Manager
Color Manager
Starting This Software
1.
Start the command prompt in Windows.
2.
In the command prompt, navigate to the directory where the executable files of this software are located.
3.
Execute commands for managing device resources.
For more information, see the following.
Viewing Help
1.
Execute the following command.
Font Manager
font-manager help
font-manager --help [COMMAND]
Color Manager
color-manager help
color-manager --help [COMMAND]
Font Manager
Font Manager is an application that manages the fonts/macros of devices as ICC profiles.
Major Functions
You can display a list of the fonts/macros installed in a device.
You can delete the fonts/macros from a device.
You can install fonts/macros to a device.
NOTE |
The fonts installed in a device by default cannot be managed with this software. The following fonts can be installed. TrueType fonts (for PCL) Type1 fonts (for PostScript) The following macros can be installed. PCL macros created with a Canon PCL driver Standard PCL macros (HP-PCL) The extension of the macros is as follows. PCL macros created with a Canon PCL driver: .p5e or .p5c Standard PCL macros: .pcl |
Supported Devices
Devices with PostScript and PCL
NOTE |
Devices with the box function are supported, as fonts/macros are saved in a box. EFI controllers are not supported. This software supports color Multi Function Printers and color printers that can download color profiles. Multi Function Printers and Printers that have a PDL download function are also supported. However, the downloading of fonts using the LPR protocol is not supported. |
System Requirements
Windows operating system with .NET Framework 4.6.2 or later installed
IMPORTANT |
This software uses the included libraries and source files to operate. It will not operate if only the application file is copied to another folder or computer. |
NOTE |
imageWARE Enterprise Management Console is not required for this software to operate. |
Commands for Managing Fonts/Macros
Specify the commands of this software in the following format.
font-manager [OPTIONS] COMMAND [args]
OPTIONS
Specify the following options.
'--user', '-u': Specify the administrator for accessing the device.
'--password', '-p': Specify the password for accessing the device.
Options can be specified in both the word or letter format.
Word format: Specify the word after '--', like '--username'.
Letter format: Specify the word after '-', like '-u'.
Some options specify a value and some do not.
Specify options that specify a value in the following format.
Connect the option and the value with '=', like '--username=Administrator'. Do not enter a space before and after '='.
Separate the option and the value with a space, like '--username Administrator'.
The above example uses an option in the word format, but the same applies for an option in the letter format.
COMMAND
The following commands can be used.
list: Displays a list of the fonts/macros installed in a device.
For more information, see the following.
delete: Deletes the specified fonts/macros from a device.
For more information, see the following.
install: Installs the specified fonts/macros to a device.
For more information, see the following.
args
Arguments may be required, depending on the command. See the description for each command.
For a command that requires a device to be specified, specify the IP address or host name of the device.
For a command that requires a device to be specified, specify the IP address or host name of the device.
Device addresses can also be specified in a text file.
Specifying Device Addresses in a Text File
To execute a process for multiple devices at once, specify the addresses of the devices in a text file.
Specify the device addresses (IP address or host name) on each line of a text file.
Specify the text file using the '--file' or '-f' option.
font-manager -u Administrator -p secret list -f hosts.txt
NOTE |
When the same device is specified multiple times, the process is repeatedly executed for that device. Only the list command can specify the devices in a text file and the command line at the same time. |
Displaying a List of the Fonts/Macros Installed in a Device
You can display a list of the fonts/macros installed in a device together with their page description language and box path.
1.
Execute the following command.
font-manager [OPTIONS] list <device addresses>
Example command
font-manager list -u Administrator -p secret 192.168.10.23
Example output
PostScript: /fonts/BlippoBT-Black
PostScript: /fonts/AmeliaBT-Regular
PCL: /macros/0
PCL: /macros/1
PCL: /fonts/Andes
PCL: /fonts/Animals Regular
PCL: /fonts/Century
PostScript: /fonts/AmeliaBT-Regular
PCL: /macros/0
PCL: /macros/1
PCL: /fonts/Andes
PCL: /fonts/Animals Regular
PCL: /fonts/Century
NOTE |
Multiple device addresses can be specified for the list command. Device addresses can be specified in a text file and the command line at the same time. |
Deleting the Fonts/Macros from a Device
You can delete the specified fonts/macros from a device.
1.
Execute the following command.
font-manager [OPTIONS] delete <device addresses> <list of font and macro names>
Specify the '--interactive' or '-i' option to interactively specify the fonts/macros to delete.
When the interactive mode is not used, font names and macro names can be specified in the arguments.
IMPORTANT |
When a font name includes spaces, the font name must be enclosed in single quotation marks ("). |
Example command
font-manager -u Administrator -p secret delete 192.168.10.23 BlippoBT-Black "Animals Regular"
Example command (interactive mode)
font-manager -u Administrator -p secret delete -i 192.168.10.23
Example output (interactive mode)
1: PostScript
2: PCL
Select PDL, or [Enter] to exit: 1
1: /fonts/BlippoBT-Black
2: /fonts/AmeliaBT-Regular
Select font to delete, or [Enter] to exit: 2
Font 'AmeliaBT-Regular' has been deleted.
1: /fonts/BlippoBT-Black
Select font to delete, or [Enter] to exit:
2: PCL
Select PDL, or [Enter] to exit: 1
1: /fonts/BlippoBT-Black
2: /fonts/AmeliaBT-Regular
Select font to delete, or [Enter] to exit: 2
Font 'AmeliaBT-Regular' has been deleted.
1: /fonts/BlippoBT-Black
Select font to delete, or [Enter] to exit:
When fonts for multiple page description languages are installed, specify the number of the page description language for the fonts to delete.
Specify the number of the fonts/macros to delete.
NOTE |
The file option and interfactive option cannot be specified at the same time. |
Installing Fonts/Macros to a Device
You can install the specified fonts/macros to a device.
1.
Execute the following command.
font-manager [OPTIONS] install <device addresses> <list of font and macro files>
When the '--overwrite' or '-o' option is specified, if a font with the same name is already installed, that font is overwritten. When the overwrite option is not specified, if a font with the same name is already installed, that font is not overwritten.
NOTE |
Specify the fonts using their file names. Multiple fonts can be specified. You can also use wildcards to specify multiple fonts at the same time. The wildcard rules are the same as for cmd.exe in Windows. When a PCL macro created with a Canon PCL driver is distributed to a device, the smallest number larger than zero that does not already exist in the device is assigned as the macro number. This macro number is used as the file name registered in the device. When a standard PCL macro is distributed to a device, the number included in the macro start command (0 to 32767) is used as the macro number. This macro number is used as the file name registered in the device. When a PCL macro that is already installed is distributed to a device, it is installed with another macro number if it is a PCL macro created with a Canon PCL driver, or overwritten if it is a standard PCL macro. |
Example command
font-manager -u Administrator -p secret install 192.168.10.23 fonts\*.ttf
font-manager -u Administrator -p secret install -o 192.168.10.23 fonts\ANDES.TTF
font-manager -u Administrator -p secret install -o 192.168.10.23 fonts\ANDES.TTF
Example output
The installation results are displayed for each specified font/macro.
'fonts\ANDES.TTF' (Andes) has been successfully installed.
IMPORTANT |
Fonts/macros cannot be installed if the box is full. European fonts will not normally cause a box to become full. |
Color Manager
Color Manager is an application that manages the ICC profiles of devices.
Major Functions
You can display a list of the ICC profiles installed in a device.
You can delete ICC profiles from a device.
You can install ICC profiles to a device.
You can back up the ICC profiles installed in a device.
You can display the information of ICC profiles on a client computer.
NOTE |
The ICC profiles installed in a device by default cannot be managed with this software. |
Supported Devices
Devices that can use ICC profiles
NOTE |
This software supports color Multi Function Printers and color printers that can download color profiles. Multi Function Printers and Printers that have a PDL download function are also supported. |
System Requirements
Windows operating system with .NET Framework 4.6.2 or later installed
IMPORTANT |
This software uses the included libraries and source files to operate. It will not operate if only the application file is copied to another folder or computer. |
NOTE |
imageWARE Enterprise Management Console is not required for this software to operate. |
Commands for Managing ICC Profiles
Specify the commands of this software in the following format.
color-manager [OPTIONS] COMMAND [args]
OPTIONS
Specify the following options.
'--user', '-u': Specify the administrator for accessing the device.
'--password', '-p': Specify the password for accessing the device.
Options can be specified in both the word or letter format.
Word format: Specify the word after '--', like '--username'.
Letter format: Specify the word after '-', like '-u'.
Some options specify a value and some do not.
Specify options that specify a value in the following format.
Connect the option and the value with '=', like '--username=Administrator'. Do not enter a space before and after '='.
Separate the option and the value with a space, like '--username Administrator'.
The above example uses an option in the word format, but the same applies for an option in the letter format.
COMMAND
The following commands can be used.
list: Displays a list of the ICC profiles installed in a device.
For more information, see the following.
delete: Deletes the specified ICC profiles from a device.
For more information, see the following.
install: Installs the specified ICC profiles to a device.
For more information, see the following.
backup: You can back up the ICC profiles in a device.
For more information, see the following.
info: You can display the information of ICC profiles on a client computer.
For more information, see the following.
args
Arguments may be required, depending on the command. See the description for each command.
For a command that requires a device to be specified, specify the IP address or host name of the device.
Device addresses can also be specified in a text file.
Specifying Device Addresses in a Text File
To execute a process for multiple devices at once, specify the addresses of the devices in a text file.
Specify the device addresses (IP address or host name) on each line of a text file.
Specify the text file using the '--file' or '-f' option.
font-manager -u Administrator -p secret list -f hosts.txt
NOTE |
When the same device is specified multiple times, the process is repeatedly executed for that device. Only the list command can specify the devices in a text file and the command line at the same time. |
Displaying a List of the ICC Profiles Installed in a Device.
You can display a list of the ICC profiles installed in a device together with other information.
1.
Execute the following command.
color-manager [OPTIONS] list <device addresses>
Example command
color-manager list -u Administrator -p secret 192.168.10.23
Example output
Name = Adobe RGB (1998)
Manufacturer = none
Copyright = Copyright 2000 Adobe Systems Incorporated
Version = 4.0
Class = DisplayDevice
ColorSpace = RGB
Filename = AdobeRGBV400.icc
Usage = Source
Name = Custom_CMYK1
Manufacturer = CANO
Copyright = Copyright CANON INC. 2002 All Rights Reserved.
Version = 2.2
Class = OutputDevice
ColorSpace = CMYK
Filename = Custom_CMYK1.icc
Usage = Source
Manufacturer = none
Copyright = Copyright 2000 Adobe Systems Incorporated
Version = 4.0
Class = DisplayDevice
ColorSpace = RGB
Filename = AdobeRGBV400.icc
Usage = Source
Name = Custom_CMYK1
Manufacturer = CANO
Copyright = Copyright CANON INC. 2002 All Rights Reserved.
Version = 2.2
Class = OutputDevice
ColorSpace = CMYK
Filename = Custom_CMYK1.icc
Usage = Source
NOTE |
Multiple device addresses can be specified for the list command. Device addresses can be specified in a file and the command line at the same time. |
Deleting ICC Profiles from a Device
You can delete the specified ICC profiles from a device.
1.
Execute the following command.
color-manager [OPTIONS] delete <device addresses> <list of profile file names>
Specify the '--interactive' or '-i' option to interactively specify the ICC profiles to delete.
When the interactive mode is not used, file names of ICC profiles can be specified in the arguments.
IMPORTANT |
When the file name of an ICC profile includes spaces, the ICC profile name must be enclosed in single quotation marks ("). |
Example command
color-manager -u Administrator -p secret delete 192.168.10.23 Custom_CMYK1.icc "AdobeRGBV400.icc"
Example command (interactive mode)
color-manager -u Administrator -p secret delete -i 192.168.10.23
Example output (interactive mode)
Delete color resources from 172.29.96.183:
1: Adobe RGB (1998)(AdobeRGBV400.icc)
2: Custom_CMYK1(Custom_CMYK1.icc)
Select color resource to delete, or [Enter] to exit:
1: Adobe RGB (1998)(AdobeRGBV400.icc)
2: Custom_CMYK1(Custom_CMYK1.icc)
Select color resource to delete, or [Enter] to exit:
Specify the number of the ICC profile to delete.
Installing ICC Profiles to a Device
You can install the specified ICC profiles to a device.
1.
Execute the following command.
color-manager [OPTIONS] install <device addresses> <list of color profile files>
When the '--overwrite' or '-o' option is specified, if an ICC profile with the same name is already installed, that ICC profile is overwritten. When the overwrite option is not specified, if an ICC profile with the same name is already installed, that ICC profile is not overwritten.
Specify the '--usage' or '-s' option to specify the intended use of the ICC profiles to install. Specify 'source', 'destination', 'devicelink' or 'spotcolor' as the intended use.
NOTE |
Specify the ICC profiles using their file names. Multiple ICC profiles can be specified. You can also use wildcards to specify multiple ICC profiles at the same time. The wildcard rules are the same as for cmd.exe in Windows. Even when the overwrite option is specified, if the intended use of the ICC profile in the device differs from the intended use specified in the command, that ICC profile is not installed. |
Example command
color-manager install -u Administrator -p secret 192.168.10.23 -s source icc-profiles\*.icc
Example output
The installation results are displayed for each specified ICC profile.
Install color resources on 192.168.10.23:
The file 'Adobe RGB (1998)' (AdobeRGBV400.icc) has been successfully installed.
The file 'Custom_CMYK1' (Custom_CMYK1.icc) has been successfully installed.
The file 'DevLink_CMYK_Custom' (DevLink_CMYK_Custom.icc) has been successfully installed.
The file 'DIC Color by Download Check' (DIC_2005_0809.icc) has been successfully installed.
The file 'E307TestProfile_Output' (Test_Output.icc) has been successfully installed.
The file 'Adobe RGB (1998)' (AdobeRGBV400.icc) has been successfully installed.
The file 'Custom_CMYK1' (Custom_CMYK1.icc) has been successfully installed.
The file 'DevLink_CMYK_Custom' (DevLink_CMYK_Custom.icc) has been successfully installed.
The file 'DIC Color by Download Check' (DIC_2005_0809.icc) has been successfully installed.
The file 'E307TestProfile_Output' (Test_Output.icc) has been successfully installed.
NOTE |
This software will not install an ICC profile in the following cases. When the device does not support the intended use specified in the command line When the device does not support the color space of the specified ICC profile The color spaces supported by devices are XYZ, Lab, RGB, and CMYK. When the device does not support the class of the specified ICC profile The classes supported by devices are InputDevice, DisplayDevice, OutputDevice, DeviceLink, ColorSpace, Abstract, NemedColor. |
Backing Up the ICC Profiles of Devices
You can retrieve the ICC profiles installed in a device and save them to a file.
1.
Execute the following command.
color-manager [OPTIONS] backup <device addresses>
Specify the '--directory' or '-d' option to specify the destination directory. If the specified directory does not exist, it is created. The current directory is specified by default.
NOTE |
The retrieved ICC profiles are saved to a sub directory with the same name as the host name in the destination directory. The file name is the internal file name of the device. If a file with the same name already exists, it is overwritten. |
Example command
color-manager -u Administrator -p secret backup -d bkup 192.168.10.23
Example output
> color-manager backup -u Administrator -p secret 192.168.10.23 bkup 192.168.10.23
Color resource data ‘Adobe RGB (1998)’ has been saved to ‘bkup\192.168.10.23\AdobeRGBV400.icc’
Color resource data ‘Adobe RGB (1998)’ has been saved to ‘bkup\192.168.10.23\AdobeRGBV400.icc’
Displaying the Information of ICC Profiles on a Computer
You can display the following information of ICC profiles on a computer.
Name
Manufacturer
Copyright
Version
Class
Color space
1.
Execute the following command.
color-manager info <list of color profile files>
NOTE |
The device address does not need to be specified. |
Example command
color-manager info icc-profiles\*.icc
Example output
ICC profile information of 'icc_profiles\Probev2_ICCv4.icc'.
Name = Probev2_ICCv4.icc
Manufacturer =
Copyright = Onyx Graphics, 2007.
Versoin = 4.0.0.0
Class = OutputDevice
ColorSpace = CMYK
ICC profile information of 'icc_profiles\SixChanCameraRef.icc'.
Name = Six Channel Abridged Reflectance Encoder/Decoder
Manufacturer =
Copyright = Copyright 2015 International Color Consortium
Versoin = 5.0.0.0
Class = InputDevice
ColorSpace = _6_Colour
Name = Probev2_ICCv4.icc
Manufacturer =
Copyright = Onyx Graphics, 2007.
Versoin = 4.0.0.0
Class = OutputDevice
ColorSpace = CMYK
ICC profile information of 'icc_profiles\SixChanCameraRef.icc'.
Name = Six Channel Abridged Reflectance Encoder/Decoder
Manufacturer =
Copyright = Copyright 2015 International Color Consortium
Versoin = 5.0.0.0
Class = InputDevice
ColorSpace = _6_Colour