Add ktx

2026-06-14 19:09:18 +01:00
parent 14bd1a9271
commit 13fa90a0e9
3958 changed files with 999286 additions and 4 deletions
@@ -0,0 +1,105 @@
+.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
+