.TH "ktx_validate" 1 "Sun Jun 14 2026 18:00:57" "Version 0.0.0" "KTX Tools Reference" \" -*- nroff -*-
.ad l
.nh
.SH NAME
ktx_validate \- ktx validate 
.PP
Validate a KTX2 file\&.
.SH "SYNOPSIS"
.PP
ktx validate [option\&.\&.\&.] \fIinput-file\fP 
.SH "DESCRIPTION"
.PP
\fBktx\fP \fBvalidate\fP validates the Khronos texture format version 2 (KTX2) file specified as the \fIinput-file\fP argument\&. It prints any found errors and warnings to stdout\&. If the \fIinput-file\fP is '-' the file will be read from the stdin\&.

.PP
The validation rules and checks are based on the official specification: KTX File Format Specification - https://registry.khronos.org/KTX/specs/2.0/ktxspec.v2.html

.PP
The JSON output formats conform to the https://schema.khronos.org/ktx/validate_v0.json schema\&.

.PP
\fBNote\fP
.RS 4
\fBktx\fP \fBvalidate\fP prints using UTF-8 encoding\&. If your console is not set for UTF-8 you will see incorrect characters in output of the file identifier on each side of the "KTX nn"\&.
.RE
.PP
.SH "OPTIONS"
.PP
The following options are available:   

.PP
.IP "\fB--format text | json | mini-json 
.IP "" 1c
Specifies the report output format\&. Possible options are: 
.br
 \fBtext\fP - Human readable text based format\&. 
.br
 \fBjson\fP - Formatted JSON\&. 
.br
 \fBmini-json\fP - Minified JSON\&. 
.br
 The default format is \fBtext\fP\&.  

.PP

.PP

.PP
.IP "\fB-g, --gltf-basisu 
.IP "" 1c
Check compatibility with KHR_texture_basisu glTF extension\&. 

.PP
.IP "\fB-e, --warnings-as-errors 
.IP "" 1c
Treat warnings as errors\&. 

.PP

.PP
.IP "\fB-h, --help 
.IP "" 1c
Print this usage message and exit\&. 

.PP
.IP "\fB-v, --version 
.IP "" 1c
Print the version number of this program and exit\&. 

.PP
.SH "EXIT STATUS"
.PP
.IP "\(bu" 2
0 - Success
.IP "\(bu" 2
1 - Command line error
.IP "\(bu" 2
2 - IO failure
.IP "\(bu" 2
3 - Invalid input file
.IP "\(bu" 2
4 - Runtime or library error
.IP "\(bu" 2
5 - Not supported state or operation
.IP "\(bu" 2
6 - Requested feature is not yet implemented  
.PP
.SH "HISTORY"
.PP
\fBVersion 4\&.0\fP
.RS 4

.IP "\(bu" 2
Initial version
.PP
.RE
.PP
.SH "AUTHOR"
.PP
.IP "\(bu" 2
Mátyás Császár [Vader], RasterGrid www\&.rastergrid\&.com
.IP "\(bu" 2
Daniel Rákos, RasterGrid www\&.rastergrid\&.com 
.PP