Skip to content

Commit a45f9c8

Browse files
committed
more README updates
1 parent b610d5a commit a45f9c8

File tree

1 file changed

+37
-10
lines changed

1 file changed

+37
-10
lines changed

README.md

Lines changed: 37 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -35,14 +35,14 @@ If you intend to develop the code for your proposes or contribute to the open so
3535

3636
### Commands:
3737

38-
- **`qct-parse`**
39-
Finds frames that exceed thresholds for QCTool tag(s). Detect color bars with the `-bd` option.
38+
- **`qct-parse -i/--input [path to QCTools report] [optional arguments]`**
39+
Finds frames that exceed thresholds for QCTool tag(s). Full list of command line arguments below.
4040

4141
---
4242

4343
# `qct-parse`
4444

45-
Run a single tag against a supplied value or multiple tags using a config file.
45+
Run a single tag against a supplied value or multiple tags using a profile.
4646

4747
## Arguments
4848

@@ -115,16 +115,43 @@ Both 8-bit and 10-bit values are supported. The bit depth will be detected autom
115115

116116
## Config Files
117117

118-
If you wish to edit the profiles stored in the config.txt files, please note that there is a separate config.txt for 8-bit and 10-bit values.
118+
The provided profiles are:
119+
* default
120+
* highTolerance
121+
* midTolerance
122+
* lowTolerance
123+
124+
Each of these profiles contain the following tags with a corresponding threshold:
125+
`YLOW, YMAX, UMIN, UMAX, VMIN, VMAX, SATMAX, TOUT, VREP`
126+
127+
The profiles are stored in the config.txt files. Please note that there is a separate config.txt for 8-bit and 10-bit values.
128+
129+
The process for providing user supplied profiles is in development.
130+
Currently, if you wish to create your own profile, you will need to create your own config directory and `config.txt` file.
131+
There is a environmental variable at the top of qct-parse.py which can be used to reset the config directory:
132+
```bash
133+
CONFIG_ENVIRONMENT_VARIABLE_NAME = 'QCT_PARSE_CONFIG_DIRECTORY'
134+
```
135+
Simply place the full path to the user created config *directory* in place of 'QCT_PARSE_CONFIG_DIRECTORY'
136+
137+
## Thumbnails
138+
139+
Thumbnails of failed frames will be exported if the `-te` flag is invoked.
119140

120141
In order to export thumbnails, the QCTools report must be in the same directory as the video file it is describing, and must have the same file name as the report (excluding the `qctools.xml.gz`).
121142

143+
If you would like to provide a path for exporting thumbnails, you can do so using the `-tep` flag.
144+
Otherwise, thumbnails will automatically be created in the same directory as the video file and QCTools report, in a new directory.
145+
146+
When running qct-parse with a profile, the thumbnails will be placed in a directory named `ThumbExports`.
147+
When run against single tags the directory will be named [TAG NAME].[THRESHOLD]
148+
122149
## Logging
123150

124-
A log file is created with the same name as the input file but with a '.log' extension.
151+
A log file is created with the same name as the input file but with a '.log' extension.
125152
For example: `some_video_file.mkv.qctools.xml.gz.log`
126153

127-
Log files contain every instance of values over the specified threshold. For example:
154+
Log files contain every instance of values over the specified threshold. For example:
128155
`2024-10-03 17:02:35,737 SATMAX is over 181.02 with a value of 698.0 at duration 00:00:16.4500`
129156

130157
---
@@ -133,20 +160,20 @@ Log files contain every instance of values over the specified threshold. For exa
133160

134161
Not in active development. Please file an issue if you are interested in using these.
135162

136-
- **`makeqctoolsreport`**
163+
#### `makeqctoolsreport`
137164

138165
A Python port of Morgan’s [makeqctoolsreport.as](https://github.com/iamdamosuzuki/QCToolsReport), this script generates QCTools `.xml.gz` reports from input video files.
139166

140-
## Example Usage
167+
Example Usage:
141168
```bash
142169
makeqctoolsreport /path/to/input.mxf
143170
```
144171

145-
- **`overcatch`**
172+
#### `overcatch`
146173

147174
A script from the original qct-parse development for running a report against multiple profiles.
148175

149-
## Example Usage
176+
Example Usage:
150177
```bash
151178
overcatch /path/to/input.mxf
152179
```

0 commit comments

Comments
 (0)