###### file parameters

# LOGGING
LOGGING_LEVEL : Logging level that will be displayed (logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR, logging.CRITICAL)
LOGGING_FILE : Logging file path (use "" if you don't want to log into a file)
LOGGING_CONSOLE : Will display logging into the console (True or False)
LOGGING_FORMAT : Format used for logging

# DISPLAY
DISPLAY_DEVICE : name of the used display: "screen" or "epd". ("screen" will work for Windows/Ubuntu, "epd" for e-paper display using Raspberry Pi). If you chose "epd", don't forget to import epd7in5_V2 from waveshare_epd (line 3)
DISPLAY_TXT_AUTHORIZED_EXTENSIONLIST : list of extension authorized into the display.txt files. If a file without these extensions is found, it will not get added into the display.txt file
DISPLAY_TXT_TIME_FORMAT : time format used into the display.txt files
DISPLAY_INPUT_TXT_PATH : path for display_input.txt file
DISPLAY_OUTPUT_TXT_PATH = path for display_output.txt file
DISPLAY_MINIMUM_PICS : Minimum files that should contain 'display_EDITpictures.txt'. If it contains less, Display Thread will not display anything (see Workflow.docx)
REBUILD_TIMER : Time, in seconds, before every rebuild from Rebuild Thread (see Workflow.docx)

# CONFIG FILES
CONFIG_PATH : config.txt file path
CONFIG_DELIMITER : config file delimiter between parameter and value
TIME_PARAMETER : name of time parameter
SORT_PARAMETER : name of sort parameter
CLEARNOW_PARAMETER : name of clearNow parameter
PIC_DIRECTORY_PARAMETER : name of pic_directory parameter
PIC_OUTPUT_DIRECTORY_PARAMETER : name of pic_output_directory parameter
LOGGING_TO_FILE_PARAMETER : name of logging_to_file parameter

# BLACKLIST/NOW FILES
BLACKLIST_PATH : blacklist.txt file path
NOW_PATH : now.txt file path
NOW_EXTENSIONLIST_SEARCHER : list of extensions that now.txt will search for if you don't write a file with his extension.

# PIC CONVERSION
COLOR_CONVERSION_PATH : output color conversion file path ("./__white__.png" or "./__black__.png")
WANTED_SIZE_X : output x size after conversion
WANTED_SIZE_Y : output y size after conversion
PICTURE_FORMAT : output format after conversion (authorized formats: .jpg, .jpeg, .png, .gif, .tga, .tif, .bmp)
WATCHER_TIMER : Time, in seconds, before Watcher Thread will search for changes into 'pictures/' (see Workflow.docx)

#OTHERS
ENCODING : encoding format for input/output files (displays.txt, logs.log, config.txt etc...)
README_PATH : README.txt file path
README_CONTENT : actual file content in an array

###### file modification while script is running

- adding/deleting files to pictures/ directory
While the script is running, you can add to-convert files in pictures/
The script will search for changes, convert them into EDITpictures/, then update display.txt files before displaying them

- You can modify now.txt, blacklist.txt and config.txt while the script is running
Changes are checked everytime
(except for config.txt[pic_directory] and config.txt[pic_output_directory])


###### blacklist.txt

#- Extension specification:
You can write files with or without extensions.
The script will automatically blacklist any existing extension on the filename or folder path.

Example:
__black__
__white__.png
2/
3/2
sample_jpg.bmp

"__black__.bmp" file will get blacklisted
"__white__.bmp" file will NOT get blacklisted (but if you add a "__white__.png" file into EDITpictures, it will get blacklisted)
All files from "2/" folder will get blacklisted: "2/1.bmp" "2/2.bmp" "2/3.bmp"
"3/2.bmp" file will get blacklisted
"sample_jpg.bmp" file will get blacklisted

Note:
blacklist always blocks "now.txt" blacklisted files


###### now.txt

#- Extension specification & restriction:
You can write files with or without extensions.
The script will automatically fill the extension (from display.py[NOW_EXTENSIONLIST_SEACHER] parameter) if the file exists into the EDITpictudes folder.

Example:
sample_bmp
sample_jpg.bmp
2/1
3/2
1/


For this example, now will bring these four first files, and all files in the folder "1/":
sample_bmp.bmp (after finding the extension alone)
sample_jpg.bmp
2/1.bmp (after finding the extension alone)
3/2.bmp
1/1.bmp (after finding the extension alone)

Note:
in this example, "1/" folder contains only one file: "1.bmp"
If you write your file with an extension into now.txt, and if it exists, the now.txt will display it.
If the file exists but you didn't mention its extension, and if its extension isn't in the display.py[NOW_EXTENSIONLIST_SEACHER] parameter, the file will not be displayed


###### clearNow

- clearNow checking
clearNow will be checked before every display. You can change this parameter: config.txt[time]

- clearNow during NOW:
If you set clearNow to 1 DURING NOW display, it will wait for NOW completion.