# Color library and converter

{% hint style="warning" %}
This tool is no longer maintained.
{% endhint %}

{% hint style="info" %}
This page is about the **Visual Basic .Net** version of the tool. If you want to read about the more up-to-date Visual Basic .Net Framework based iteration, head over to the [Color converter (VB.Net Framework)](https://mrcmodding.gitbook.io/home/vbnetframework/color-library-and-converter) page.
{% endhint %}

## Features

* Convert between color formats
  * sRGB 8-bit
  * sRGB
  * linear RGB
* Save and load colors from formatted .xml file
* Generate color sample cards
* Pick color from loaded or copy-pasted images

The Color library and converter is the third iteration of the color converter tool. It is written in Visual Basic .Net. It integrates the converter part of the previous iteration with a structured color library, which allows for categories as well, and a color picker window.

### Conversion

<figure><img src="https://3093199008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW202g4rqtsk2O6cTvlfr%2Fuploads%2FLW515syZWhJPkSbNAy5h%2Fimage_2_1.png?alt=media&#x26;token=8a73e5c4-6626-4122-acd7-195e9e3af6ab" alt=""><figcaption></figcaption></figure>

Before conversion, the value to be converted, and the format of the input value has to be set. If the input value in one of the RGB fields is invalid for the selected input format, the result fields are displayed empty after conversion. If all 3 RGB values could be successfully converted, a color sample is displayed at the bottom of the window.

### Pick a color

The color picker area accepts existing images by drag-and-drop and opening through file explorer, as well as images pasted from the clipboard.

### Color library

The color library is stored in [XML files](https://mrcmodding.gitbook.io/home/vbnet/color-library-and-converter/color-library-xml) with specific formatting:

```xml
<?xml version="1.0" encoding="utf-8"?>
<color>
  <category>
	<name>Category 1</name>
	<color>
	  <name>Some color</name>
	  <format>3</format>
	  <R>0.353</R>
	  <G>0.101</G>
	  <B>0</B>
	</color>
  </category>
  <category>
	<name>Category 2</name>
  </category>
</color>
```

### Color cards

Color cards can be generated from colors saved in the current library. The main body of the card is of the selected color, and the annotation block contains the name and color codes.

<figure><img src="https://3093199008-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FW202g4rqtsk2O6cTvlfr%2Fuploads%2Ftrt2Z5lGW6SpeQzXbZTw%2Fimage_2_2.png?alt=media&#x26;token=70de680b-078d-4f16-bed9-261b933cf498" alt=""><figcaption></figcaption></figure>

The name of the color format in which the color is saved in the library is always underlined. This is to indicate which format is the most precise (while conversion is precise, ±0.001 deviation can sometimes be observed in the converted values due to rounding).

**Options:**

* **Annotation:**
  * **Name:**
    * **Library name:** include the library name of the color
    * **Custom name:** prompt for a custom name
  * **Color codes:**
    * **Source format:** include only the source format values
    * **All formats:** include all converted values
* **Export target:**
  * **To file:** save color card to file in PNG format (300 x 300 pixels, rounded corners)
  * **To clipboard:** copy color card to system clipboard (300 x 300 pixels, straight corners)

## Environment

* Logic: Visual Basic .Net 5.0
* GUI: Windows Forms

## Requirements

* .NET 5.0


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mrcmodding.gitbook.io/home/vbnet/color-library-and-converter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.