TexView 2 Manual: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Some wiki formatting)
 
(25 intermediate revisions by 10 users not shown)
Line 1: Line 1:
[[TexView 2]]
{{TOC|side}}
[[TexView 2]] is a texture viewer and conversion tool supporting Real Virtuality Engine's internal texture formats.
TexView 2 is provided free of charge for any non-commercial use without any support from {{Name|bi}}. Use it at your own risk.
Refer to the end user license agreement as displayed during the setup process of this application for more details.


TextView 2 is texture viewer and conversion tool supporting internal texture formats of Bohemia Interactive's game engines.
=== Supported Formats ===


TexView 2 is provided free of charge for any non-commercial use without any support from Bohemia Interactive. Use it at your own risk. Refer to the end user license agreement as displayed during the setup process of this application for more details.
{| class="wikitable valign-top"
! style="width: 50%" | Input
! style="width: 50%" | Output
|-
|
* JPG
* TGA (24 bit / 32 bit with alpha channel)
* PNG (with or without alpha channel)
* PAA
* PAC


===Supported formats===
{{Feature|important|
All input textures '''must''' have a power of two-based resolution like 2^x / 2^y (e.g. 16 / 16, 32 / 32, 64 / 64, 256 /256).
The largest texture size commonly supported by graphics cards and BI's game engines is 2048x2048,
in {{arma3}} 4096x4096 textures are supported (and are in TexView 2).
}}
|
* PAA/PAC (file format is used depending on file name as defined in textureconvert.cfg file)
* TGA (32 bit with alpha channel)
* PNG (with alpha channel)
|}


Input:
=== How to use it ===
JPG
TGA (24 bit / 32 bit with alpha channel )
PNG (with or without alpha channel)
PAA
PAC


Important note: All input textures must have resolution 2^x / 2^y (e.g. 16 / 16, 32 / 32, 64 / 64, 256 /256). The largest texture size commonly supported by graphics cards and BI's game engines is 2048x2048, in future graphics textures 4096x4096 or even larger could be possible and it is already supported in TexView 2.
Output:
PAA/PAC (file format is used depending on file name as defined in textureconvert.cfg file)
TGA (32 bit with alpha channel)
PNG (with alpha channel)
===How to use it===
You can open any supported image using menu File / Open or drag and drop the image file icon into the main window of Texview (tip: you may assign PAA file extensions to TexView 2application using Windows desktop).
You can open any supported image using menu File / Open or drag and drop the image file icon into the main window of Texview (tip: you may assign PAA file extensions to TexView 2application using Windows desktop).


You can save the file into the format you need. The output file format (PAC, PAA or TGA) will be choosen depending on the extension you write in "Save As..." dialog to the filename line. Bit depth and optional alpha channel will be selected automaticaly depending on the file name as defined in textureconvert.cfg file, default is:
You can save the file into the format you need. The output file format (PAC, PAA or TGA) will be choosen depending on the extension you write in "Save As..." dialog to the filename line.
Bit depth and optional alpha channel will be selected automatically depending on the file name as defined in textureconvert.cfg file, default is:


    * _CO - color (difuse map)
* _CO - color (diffuse map)
    * _CA - color alpha (difuse map with alpha)
* _CA - color alpha (diffuse map with alpha)
    * _NO - normal map
* _NO - normal map
    * _NS - normal map specular (with alpha)
* _NS - normal map specular (with alpha)
    * _NOF - normal map faded (mipmaps fade the texture in distance, usefull for terrain)
* _NON - normal map with noise in alpha channel ( noise is used for vegetation lods blending)
    * _NOHQ - normal map high quality
* _NOF - normal map faded (mipmaps fade the texture in distance, usefull for terrain)
    * _NOVHQ - normal map high quality
* _NOHQ - normal map high quality
    * _DT - detail texture, average color should be 0.5, texture has got fad out filter in mipmaps
* _NOVHQ - normal map high quality
    * _CDT - colored detail texture, average color should be 0.5 in all R G B channels, texture has got fad out filter in mipmaps
* _DT - detail texture, average color should be 0.5, texture has got fad out filter in mipmaps
    * _SKY - sky texture
* _CDT - colored detail texture, average color should be 0.5 in all R G B channels, texture has got fad out filter in mipmaps
    * _MC - macro texture
* _SKY - sky texture
    * _AS - ambient shadow texture
* _MC - macro texture
    * _SM - specular map HQ normálové mapy (HQ Normal Maps)
* _AS - ambient shadow texture
    * _SMDI - optimised specular mapa for better bitdepth HQ_normálové_mapy_
* _SM - specular map HQ normálové mapy (HQ Normal Maps)
    * _LCO - land color map, texture used for satelite and mask textures on the terrain
* _SMDI - optimised specular mapa for better bitdepth HQ_normálové_mapy_
    * _MCO - multiply color map, texture used to multiply with color map (as cdt) without fade out filter, average color should be 0.5 in all R G B channels  
* _LCO - land color map, texture used for satelite and mask textures on the terrain
* _MCO - multiply color map, texture used to multiply with color map (as cdt) without fade out filter, average color should be 0.5 in all R G B channels  


The texture name should be simple ascii, containing only letters, digits and underscore (no letters with diacritics). Only one dot is allowed leading the extension.
The texture name should be simple ascii, containing only letters, digits and underscore (no letters with diacritics). Only one dot is allowed leading the extension.
Line 51: Line 59:
The source texture file format is PNG (preferred) or TGA (no compression, only 24b or 32b).  
The source texture file format is PNG (preferred) or TGA (no compression, only 24b or 32b).  


Please be aware that bit depth of the exported texture may be lower than bit depth of your source image and compression causing some visual artifacts can be applied. During the export all mipmap levels of the texture will be created automatically. Alternatively, you can also move the texture by holding the middle mouse button.
Please be aware that bit depth of the exported texture may be lower than bit depth of your source image and compression causing some visual artifacts can be applied.
During the export all mipmap levels of the texture will be created automatically. Alternatively, you can also move the texture by holding the middle mouse button.


Reference: [[Arma: Texture Naming Rules]].


===Available functions===
=== Available Functions ===
 
==== File ====
===== Open =====
{{Controls|Ctrl|O}}


====File====
=====Open [Ctrl + O]=====
open an image file
open an image file


=====Save [Ctrl + S]=====
===== Save =====
{{Controls|Ctrl|S}}
 
Saves the file in the support file format (paa is default for any unsupported extension)
Saves the file in the support file format (paa is default for any unsupported extension)


=====Refresh [F5]=====
===== Refresh =====
{{Controls|F5}}
 
Reloads the file
Reloads the file


=====Save as... =====
===== Save as... =====
Export the image file to desired format (default is paa but you can manually change the extension to tga or png)
Export the image file to desired format (default is paa but you can manually change the extension to tga or png)


=====Source control=====
===== Source control =====
Allows to bind data to a scc compliant source control system
Allows to bind data to a scc compliant source control system


=====Generate=====
===== Generate =====
Allows simple procedural texture generation based on formulas, example of a circle texture:  
Allows simple procedural texture generation based on formulas, example of a circle texture:  
  a=abs(u)<sqrt(1-v*v);
  a = abs u < sqrt(1 - v * v);
  r=a;
  r = a;
  g=a;
  g = a;
  b=a
  b = a;
 
===== Previous File / Next File =====
{{Controls|PageUp}} (previous file) / {{Controls|PageDown}} (next file)


=====Next File (Page Down) / Previous File (Page UP) =====
Browses the current directory for other bitmaps
Browses the current directory for other bitmaps


====Edit--Filter====
==== Edit > Filter ====
Filter process executed for each pixel of the texture. You can load some of pre-made useful filters stored in Filters subfolder of main Tex View 2 working directory.
Filter process executed for each pixel of the texture. You can load some of pre-made useful filters stored in Filters subfolder of main Tex View 2 working directory.


====MipMap====
==== MipMap ====


=====Prev [up]=====
===== Prev =====
Display previous mipmap level
{{Controls|Up}}


=====Next [down]=====
Display the previous mipmap level
Display next mipmap level


=====Preview mipmaps=====
===== Next =====
{{Controls|Down}}
 
Display the next mipmap level
 
===== Preview mipmaps =====
Generate mipmaps
Generate mipmaps
=====Preview mipmap=====
 
===== Preview mipmap =====
Specific types: preview various specific supported mipmap types
Specific types: preview various specific supported mipmap types


====View====
==== View ====
=====Status Bar====
 
===== Status Bar =====
Display resolution of the currently displayed mipmap and maximum resolution of the texture and status of Tex View 2
Display resolution of the currently displayed mipmap and maximum resolution of the texture and status of Tex View 2


=====Info bar=====
===== Info bar =====
Display max, avg and under cursor color in RGBA
Display max, avg and under cursor color in RGBA
=====View bar=====
 
===== View bar =====
Allows you to select, preview and compare various types of textures (note that texture type to be stored is determined by filename only and this is only for preview purposes)
Allows you to select, preview and compare various types of textures (note that texture type to be stored is determined by filename only and this is only for preview purposes)
=====Zoom In [+] / Zoom Out [-]=====
 
===== Zoom In / Zoom Out =====
{{Controls|Num+}} / {{Controls|Num-}}
 
Zoom the texture in and out (you can also use mouse wheel to zoom in and out)
Zoom the texture in and out (you can also use mouse wheel to zoom in and out)
=====RGB (0..1)=====
Show RGB values on scale from 0 to 1 and not from 0 to 255


====Mouse controls====
===== RGB =====
Hold right mouse button and drag the texture by mouse if it can't fit on screen, use mouse wheel to zoom in and out.
Show RGB values on a 0..1 scale (not 0..255)
 
==== Mouse controls ====
Hold {{{{Controls|RMB}} and drag the texture by mouse if it cannot fit on screen, use mouse wheel to zoom in and out.


===Command Line Conversion===
=== Command Line Conversion ===


For commandline and batch conversions use Pal2PacE.exe.  
For command line and batch conversions use [[Pal2PacE]].exe.  


Arguments used:
'''Arguments Usage''':
Usage: pal2pace [saveoptions] <source> [<destination>]
  pal2pace [saveoptions] <source> [<destination>]
or      pal2pac -combine [saveoptions] [options] <source1> <source2> <source3>
pal2pac -combine [saveoptions] [options] <source1> <source2> <source3> <source4> <destination>
<source4> <destination>


SaveOptions:
'''SaveOptions''':
        -size=<n>
<pre>        -size=<n>


Options:
Options (obsolete, no longer useful for {{arma1}}):
         -xborder=<bordersize> (0<bordersize<0.5, default 0.125)
         -xborder=<bordersize> (0<bordersize<0.5, default 0.125)
         -yborder=<bordersize>
         -yborder=<bordersize>
Line 132: Line 160:
         -water=<watername>
         -water=<watername>


example how to generate new paa files from TGA sources:  
Example of how to generate new [[paa]] files from TGA sources:  
Pal2PacE x:\Test\*.tga
Pal2PacE x:\Test\*.tga
</pre>
 
 
== See Also ==
 
* [[TexView 2]]
* [[PAA File Format]]
* [[Arma: Texture Naming Rules]]
 
 
{{GameCategory|arma1|Addon Editing}}
{{GameCategory|arma1|Official Tools}}
{{GameCategory|arma2|Official Tools}}
{{GameCategory|arma3|Official Tools}}

Latest revision as of 22:54, 4 May 2024

TexView 2 is a texture viewer and conversion tool supporting Real Virtuality Engine's internal texture formats. TexView 2 is provided free of charge for any non-commercial use without any support from Bohemia Interactive. Use it at your own risk. Refer to the end user license agreement as displayed during the setup process of this application for more details.

Supported Formats

Input Output
  • JPG
  • TGA (24 bit / 32 bit with alpha channel)
  • PNG (with or without alpha channel)
  • PAA
  • PAC
All input textures must have a power of two-based resolution like 2^x / 2^y (e.g. 16 / 16, 32 / 32, 64 / 64, 256 /256).

The largest texture size commonly supported by graphics cards and BI's game engines is 2048x2048,

in Arma 3 4096x4096 textures are supported (and are in TexView 2).
  • PAA/PAC (file format is used depending on file name as defined in textureconvert.cfg file)
  • TGA (32 bit with alpha channel)
  • PNG (with alpha channel)

How to use it

You can open any supported image using menu File / Open or drag and drop the image file icon into the main window of Texview (tip: you may assign PAA file extensions to TexView 2application using Windows desktop).

You can save the file into the format you need. The output file format (PAC, PAA or TGA) will be choosen depending on the extension you write in "Save As..." dialog to the filename line. Bit depth and optional alpha channel will be selected automatically depending on the file name as defined in textureconvert.cfg file, default is:

  • _CO - color (diffuse map)
  • _CA - color alpha (diffuse map with alpha)
  • _NO - normal map
  • _NS - normal map specular (with alpha)
  • _NON - normal map with noise in alpha channel ( noise is used for vegetation lods blending)
  • _NOF - normal map faded (mipmaps fade the texture in distance, usefull for terrain)
  • _NOHQ - normal map high quality
  • _NOVHQ - normal map high quality
  • _DT - detail texture, average color should be 0.5, texture has got fad out filter in mipmaps
  • _CDT - colored detail texture, average color should be 0.5 in all R G B channels, texture has got fad out filter in mipmaps
  • _SKY - sky texture
  • _MC - macro texture
  • _AS - ambient shadow texture
  • _SM - specular map HQ normálové mapy (HQ Normal Maps)
  • _SMDI - optimised specular mapa for better bitdepth HQ_normálové_mapy_
  • _LCO - land color map, texture used for satelite and mask textures on the terrain
  • _MCO - multiply color map, texture used to multiply with color map (as cdt) without fade out filter, average color should be 0.5 in all R G B channels

The texture name should be simple ascii, containing only letters, digits and underscore (no letters with diacritics). Only one dot is allowed leading the extension.

Example of texture name: M151A1_fuelTank01_CO.tga

The source texture file format is PNG (preferred) or TGA (no compression, only 24b or 32b).

Please be aware that bit depth of the exported texture may be lower than bit depth of your source image and compression causing some visual artifacts can be applied. During the export all mipmap levels of the texture will be created automatically. Alternatively, you can also move the texture by holding the middle mouse button.

Reference: Arma: Texture Naming Rules.

Available Functions

File

Open

Ctrl + O

open an image file

Save

Ctrl + S

Saves the file in the support file format (paa is default for any unsupported extension)

Refresh

F5

Reloads the file

Save as...

Export the image file to desired format (default is paa but you can manually change the extension to tga or png)

Source control

Allows to bind data to a scc compliant source control system

Generate

Allows simple procedural texture generation based on formulas, example of a circle texture:

a = abs u < sqrt(1 - v * v);
r = a;
g = a;
b = a;
Previous File / Next File

↟ PgUp (previous file) / ↡ PgDown (next file)

Browses the current directory for other bitmaps

Edit > Filter

Filter process executed for each pixel of the texture. You can load some of pre-made useful filters stored in Filters subfolder of main Tex View 2 working directory.

MipMap

Prev

Display the previous mipmap level

Next

Display the next mipmap level

Preview mipmaps

Generate mipmaps

Preview mipmap

Specific types: preview various specific supported mipmap types

View

Status Bar

Display resolution of the currently displayed mipmap and maximum resolution of the texture and status of Tex View 2

Info bar

Display max, avg and under cursor color in RGBA

View bar

Allows you to select, preview and compare various types of textures (note that texture type to be stored is determined by filename only and this is only for preview purposes)

Zoom In / Zoom Out

NUM + / NUM -

Zoom the texture in and out (you can also use mouse wheel to zoom in and out)

RGB

Show RGB values on a 0..1 scale (not 0..255)

Mouse controls

Hold {{Right Mouse Button and drag the texture by mouse if it cannot fit on screen, use mouse wheel to zoom in and out.

Command Line Conversion

For command line and batch conversions use Pal2PacE.exe.

Arguments Usage:

pal2pace [saveoptions] <source> [<destination>]
pal2pac -combine [saveoptions] [options] <source1> <source2> <source3> <source4> <destination>

SaveOptions:

        -size=<n>

Options (obsolete, no longer useful for {{arma1}}):
        -xborder=<bordersize> (0<bordersize<0.5, default 0.125)
        -yborder=<bordersize>
        -mask=<maskname>
        -water=<watername>

Example of how to generate new [[paa]] files from TGA sources: 
 Pal2PacE x:\Test\*.tga


See Also