Hexpixel Code

From Wikibooks, the open-content textbooks collection

The Hexpixel Code is an easy-to-use language used to create images in text editors using hex triplets.

Contents 1 Introduction 1.1 Quick Rules 2 Starting out 3 Adding the Pixels/Hex triplets 4 Ending 5 Transpareny 5.1 Partial Transparency 6 Animated Images 7 Variables 7.1 Preassigned Variables 7.2 Variable Rules 8 Consecutives 8.1 Consecutive Pixels and Variables 8.2 Consecutive Lines 9 Additional Color Space Support 9.1 RGB 9.2 HSL 9.3 CMYK 10 Examples 10.1 One Line 10.2 Two Lines 10.3 Variables 10.3.1 One Variable 10.3.2 Two Variables 10.3.3 Multivars 10.4 Animated Images 10.4.1 Animated Images with Loops 10.5 Consecutives 10.5.1 Consecutive Pixels 10.5.2 Consecutive Lines 10.5.3 Consecutive Pixels and Lines 10.6 Additional Color Spaces 10.6.1 RGB 10.7 Examples Real-life Images 10.7.1 Hi.HPC 10.7.1.1 Code 10.7.1.2 Image 10.7.2 Smiley.HPC 10.7.2.1 Code 10.7.2.2 Image 11 Authors

[edit] Introduction

The reason the language is called The Hexpixel Code is because it is a language (or code) which uses Hex triplets and goes pixel by pixel. With this language, you can create images in Notepad.

[edit] Quick Rules

1. ONLY these characters are allowed:

   ()[]-;=ABCDEFGHIJKLMNOPQRSTUVWXxYZ0123456789
   

   Take note that there are no lowercase letters or spaces except x.
2. All beginning statements ( or [ must be ended, with a ) or ].

[edit] Starting out

It is time to start. Please read and follow the directions very carefully. Use copy and paste to help you when you see the code boxes because it is very easy to make a simple typo with character mistakes.

1. Open Notepad or another text editor.
2. Open a small image using a bitmap graphics editor preferably Paint.
3. Type the following into your text editor:

   (HPC1)
   

   This means Hexpixel Code Version 1.
4. Find the dimensions of your image. (Width and Height)
5. Add

   (WIDTHxHEIGHT)
   

   to your text (with no spaces). Now, it should look like this:

   (HPC1)(WIDTHxHEIGHT)
   

6. Replace WIDTH with the width of your image and replace HEIGHT with the Height of your image.
   If your width was 4 and your height was 3, your text should look like this:

   (HPC1)(4x3)
   

7. Add

   (START)
   

   to your text.

[edit] Adding the Pixels/Hex triplets

Read the following instructions to learn how to properly add pixels (Hex triplets) to your text.

1. Add

   [HC1][HC2][HC3]
   

   etc. to your text.
2. Replace HC1 with the Hex triplet of the first pixel in the first line of your image.
   For example, if the first pixel in the first line was black, you would look it up here (it is #FFFFFF), and you would replace it with HC1.
3. Replace HC2, HC3, etc. the same way you did with HC1 above.
4. Delete the #s in the text.
5. When you get to the second line of your image, add a comma to your text then you may go to the second line of your image.

[edit] Ending

Read the following instructions to learn how to properly end the text.

1. Add

   (END)
   

   to the end of your text after you are done with all the lines and pixels of your image to end.
2. You are done, but read the rest to make your file smaller, etc.

[edit] Transpareny

Use:

[TRANSP]

or

[NNNNNN]

for transparent pixels. Read further for the variables available for transparent pixels.

[edit] Partial Transparency

Partial transparency support is currently unavailable in Hexpixel Code Version 1 and will/might be available later in version 1 or in version 2, 3, 4, etc.

[edit] Animated Images

Read the following instructions to learn how to properly create animated image files.

1. If you have an animated image, after the (WIDTHxHEIGHT and Before the ) in the text, add an A.
2. After the A, Add the number of frames your animated image has.
3. After the frames count, add a comma to your text and add the frame rate (in seconds) of the Animated Image.
4. After the frame rate, write an L and then how many times the animated image loops. If it loops infinite times, put I.
5. Normally, the ) will go to end the statement (but don't have two in a row ever).

When separating between frames, use two commas.

[edit] Variables

Read the following instructions to learn how to properly assign variables and lower the filesize.

1. If you use a pixel such as [F0F8FF] more than once, you can assign a variable for it.
2. To shorten a pixel such as [F0F8FF] to a variable such as [AB], after the (WIDTHxHEIGHT) and before the (START), add

   ([AB]=[F0F8FF])
   

   or

   ([F0F8FF]=[AB])
   

   to your text.

[edit] Preassigned Variables

The variables below are variables that are preassigned and will be recognized without assigning them.

[0]=[000000]
[F]=[FFFFFF]
[W]=[FFFFFF]
[B]=[0000FF]
[Y]=[FFFF00]
[R]=[FF0000]
[G]=[00FF00]
[V]=[FF00FF]
[P]=[FF00FF]
[A]=[00FFFF]
[C]=[00FFFF]
[N]=[NNNNNN]  /Transparent
[T]=[TRANSP]  /Transparent

[edit] Variable Rules

1. Anything above six character or below one character variables are not allowed.
2. You cannot reassign a pixel or a variable to preassigned variables.
3. You cannot assign a variable or preassigned variables to another variable unless they are multiple.
4. You may assign multiple pixels and multiple variables to a variable.
5. Variables can only have these characters:

   ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789
   

   If you have a con or a conline you can also have a - or ;.

[edit] Consecutives

Read the following instructions to learn how to properly assign Consective Pixels/Variables (cons).

[edit] Consecutive Pixels and Variables

1. If you use a pixel or a variable such as [F0F8FF] more than once in the same Consecutive order, you can shorten it into a conpixvar.
2. If you saw a string of pixels (or variables) in an order like this:

   [F0F8FF][F0F8FF][F0F8FF][F0F8FF][F0F8FF]
   

   you can shorten the string by deleting those pixels and then adding something like this:

   [F0F8FF-5]
   

   For each non-conpixvar you can add a -1 within the pixel (or variable) but this is unnecessary because it increases filesize.

[edit] Consecutive Lines

1. If you saw a string of pixels (or variables) in an order, like this:

   [F0F8FF][0][CADABA][FC0FC0],[F0F8FF][0][CADABA][FC0FC0],[F0F8FF][0][CADABA][FC0FC0]
   

   you can shorten the string by assigning a variable, example:

   ([F0F8FF][0][CADABA][FC0FC0]=[1])
   

   then you can put your three conlines:

   [1;3],[x-3],[x-3]
   

2. Use the [x] where the conlines assigned pixels.
3. When put together, the full text looks something like this:

   (HPC1)(4x3)([F0F8FF][0][CADABA][FC0FC0]=[1])(START)[1;3],[x-3],[x-3](END)
   

For each non-conline you can add a ;1 within the pixel (or variable) but this is unnecessary because it increases filesize.

[edit] Additional Color Space Support

[edit] RGB

If you know the RGB of a color but not the hex color code, you can:

1. Use this website to convert.
2. Put the RGB into the pixel format (which increases the filesize):

Put this in your code:

[RGB]

Replace R with the red in the color (000-255).

Replace G with the green in the color (000-255).

Replace B with the blue in the color (000-255).

All RGB pixels have exactly 9 characters inside the brackets.

[edit] HSL

If you know the HSL of a color but not the hex color code, you can:

1. Convert it to hex using this formula.
2. Put the RGB into the pixel format (which increases the filesize):

Put this in your code:

[xHSL]

Replace H with the hue in the color (000-360).

Replace S with the saturation in the color (000-100).

Replace L with the luminance in the color (000-100).

All RGB pixels have exactly 10 characters inside the brackets.

[edit] CMYK

If you know the CMYK of a color but not the hex color code, you can:

1. Use this website to convert.
2. Put the RGB into the pixel format (which increases the filesize):

Put this in your code:

[CMYK]

Replace C with the cyan in the color (000-100).

Replace M with the magenta in the color (000-100).

Replace Y with the yellow in the color (000-100).

Replace K with the black in the color (000-100).

All CMYK pixels have exactly 12 characters inside the brackets.

[edit] Examples

Below are examples to help you.

[edit] One Line

(HPC1)(3x1)(START)[F0F8FF][E32636][FFBF00](END)

[edit] Two Lines

(HPC1)(3x1)(START)[F0F8FF][E32636][FFBF00],[F0F8FF][E32636][FFBF00](END)

[edit] Variables

[edit] One Variable

(HPC1)(3x1)([1]=[F0F8FF])(START)[1][E32636][FFBF00](END)

[edit] Two Variables

(HPC1)(3x1)([1]=[F0F8FF])([AI]=[E32636])(START)[1][AI][FFBF00](END)

[edit] Multivars

(HPC1)(2x1)([F0F8FF][E32636]=[1])(START)[1](END)

[edit] Animated Images

[edit] Animated Images with Loops

(HPC1)(3x1A2,7)(START)[F][F0F8FF][FFBF00],,[0][F0F8FF][FFBF00](END)

[edit] Consecutives

[edit] Consecutive Pixels

(HPC1)(3x1)(START)[E32636-3](END)

[edit] Consecutive Lines

(HPC1)(1x3)(START)[E32636;3],[x],[x](END)

[edit] Consecutive Pixels and Lines

(HPC1)(3x3)(START)[E32636-3;3],[x-3],[x-3](END)

(HPC1)(6x4)(START)[E32636-3;4][G-3],[x-3][F-3],[x-3][0-2][Y],[x-3][G][R][F](END)

[edit] Additional Color Spaces

[edit] RGB

(HPC1)(1x1)(START)[000000000](END)

(HPC1)(1x1)(START)[103255100](END)

[edit] Examples Real-life Images

[edit] Hi.HPC

[edit] Code

(HPC1)(7x3)(START)[0][F][0][F][0-3],[0-3][F-2][0][F],[0][F][0][F][0-3](END)

[edit] Image

[edit] Smiley.HPC

[edit] Code

(HPC1)(12x11)(START)[F-4][0-4][F-4],
[F-2][0-2][Y-4][0-2][F-2],[F][0][Y-8][0][F],
[F][0][Y-2][0-2][Y-2][0-2][Y][0][F],[0][Y-3][0][Y-2][0][Y-3][0],
[0][Y-10][0],[0][Y-2][0][Y-4][0][Y-2][0],
[F][0][Y-2][0-4][Y-2][0][F],[F][0][Y-8][0][F],
[F-2][0-2][Y-4][0-2][F-2],[F-4][0-4][F-4](END)

[edit] Image

[edit] Authors

• Domthedude001, First author of this Wikibook and creator of the Hexpixel Code.
• All of the other contributors