User:Fahrenheit: Difference between revisions

From AniDB
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(26 intermediate revisions by one other user not shown)
Line 1: Line 1:
------------------ New Anime Page Patterns ------------------
{{TOCright}}
%ann Anime Title (uses default language definitions)
 
%anja Anime Title japkanji (defaults to %ann)
== New Anime Page Patterns and Usage ==
%anro Anime Title romaji (default fallback language)
 
%anen Anime title english (defaults to %ann)
Implemented, official page at: [[PAGE_PREFERENCES_ED2K]].
%epn Episode Title (uses default language definitions)
 
%epja Episode title japkanji (defaults to %epn)
== Custom filters for files ==
%epro Episode title romaji (defaults to %epn)
The new anime page supports custom filters for files. Currently there are 4 types of filters:
%epen Episode title english (default fallback language)
;Deprecated : this filter marks files as deprecated
%enr Episode number
;Unfiltered : this one checks which files don't get filtered
%pn Part name ("EP" if anime.type != 4 || "PA" otherwise)
;Visible : checks to see which files even if marked as to be hidden should be displayed
%pnf Full part name ("Episode" if anime.type != 4 || "Part" otherwise)
;Hidden : hides files based on user preferences
%raw if file is raw (no subtitles outputs RAW)
 
%crc Crc sum or INVALID if crc invalid
The default rules for each filter follow the [[Files:Deprecated_files|Deprecated files]] rules currently implemented in AniDB except for the Hidden filter that also hides files based on user profile language preferences.
%ver Version string (only if version > 1)
 
%cen Censored string
----
%dub Dub languages (ALL OF THEM, comma separated)
 
%sub Sub languages (ALL OF THEM, comma separated)
=== Syntax and some rules ===
%lang dub.sub_jp+.de+ (current db format)
 
%langs dub.sub_jp,de,en.de,en (extended format)
Filter Syntax:<br>
%grp Group short name
Except for element "0", that states how many rules there are, elements follow this format:<br>
%grn Group full name
"'''RULE NUMBER'''":{"'''RULE SUBJECT''' #1":"'''OPERATION''','''TEST'''";"'''RULE SUBJECT''' #2":"'''OPERATION''','''TEST'''"; etc};<br>
%qual Quality
<br>
%src Source
Where '''RULE SUBJECT''' can be one of the following:
%res Resolution
<br>
%vid Video codec
;fdate : File add date
%eps Total number of episodes
;eusers : Total number of users for this episode
%type [unknown, TV, OVA, Movie, Other, web]
;fusers : Total number of users for this file
%fid File ID
;fcrc : File CRC status (valid, invalid, unknown)
%aid Anime ID
;fqual : File quality
%eid Episode ID
;fgroup : File Group Id
%gid Group ID
;fversion : File version
;finmylist : File is in MyList
;efvisible : Total number of files
;falang : Any of the file audio languages is one of the preferred langs (if using obj.filterAudLang) or given lang
;fslang : Any of the file audio languages is one of the preferred langs (if using obj.filterSubLang) or given lang
;ftype : File type (generic)
;fsource : File source (HDTV, DTV, etc)
;fextension : File extension (mkv, avi, mov, etc)
;fdeprecated : Is file deprecated
;fraw : Is file RAW
;fgroupfiltered : Is group filtered
<br>
'''Notes:'''
* When '''RULE SUBJECT''' is prefixed with "c_sf_", there will be test of comparison for all files of the episode and the results of this comparison will be stored in processing Files
* When '''RULE SUBJECT''' is prefixed with "c_rf_", there will be test of comparison for all files stored in processing Files, and the list will be updated with the results
* No '''RULE SUBJECT''' prefixed with "c_" imply that you are testing an attribute, think of it as a SQL select where
<br>
'''OPERATION''' can be one of the following:
<br>
;> : greater than
;< : lesser than
;>= : greater or equal than
;<= : lesser or equal than
;== : Equal to
;!= : Not equal to
<br>
Where '''TEST''' is the value to test, there are special cases:
<br>
;this : will test against the same '''RULE SUBJECT''' (only used in "c" prefixed '''RULE SUBJECTS''')
<br>
'''Notes:'''
* For each '''RULE NUMBER''' the '''RULE SUBJECTS''' are tested using '''AND'''
* Will only test '''RULES''' until end or a failed test
 
----
 
==== Default Unfiltered ====
<pre>filterObj.defaultUnfiltered = {0:2,
                              1:{"fdate":"<,172800"},
                              2:{"ftype":"==,generic"}};</pre>
 
==== Default Deprecated ====
<pre>filterObj.defaultDeprecated = {0:5,
                            1:{"eusers":">=,50","fusers":"<=,3","fcrc":"!=,valid"},
                            2:{"fcrc":"==,invalid"},
                            3:{"fqual":">,1","fqual":"<=,5"},
                            4:{"c_sf_fgroup":"==,this","c_rf_fsource":"==,this","c_rf_fversion":"==,this","c_rf_fextension":"==,this","c_rf_fcrc":"==,valid","fcrc":"!=,valid","fgroup":"!=,0"},
                            5:{"c_sf_fgroup":"==,this","c_rf_fsource":"==,this","c_rf_fversion":">,this","c_rf_fextension":"==,this","c_rf_fcrc":"==,valid","fgroup":"!=,0"}}
</pre>
 
==== Default Visible ====
<pre>filterObj.defaultVisible = {0:5,
                            1:{"fdeprecated":"==,true"},
                            2:{"finmylist":"==,true"},
                            3:{"fusers":">=,50"},
                            4:{"fdate":"<,604800"},
                            5:{"efvisible":"<,1"}};</pre>
 
==== Default Hidden ====
<pre>filterObj.defaultHidden = {0:2,
                          1:{"falang":"==,obj.filterAudLang"},
                          2:{"fslang":"==,obj.filterSubLang"}};</pre>
 
=== Example of usage ===
 
Imagine you had a ''fcen'' that would return true if a file is marked as censored, ''funcen'' that would return true if a file is marked as uncensored and a ''acen'' that would return true if the current anime has been marked as +18.
Having this if you wanted to hide all censored files for a +18 anime and only leave uncensored or not marked files you would add this to the hidden filter.
 
<pre>filterObj.hidden = {0:1,
                    1:{"acen":"==,true","fcen":"==,true"}};</pre>
 
This filter would mark as hidden all censored files for a +18 anime.
 
'''Notes:''' obviously this isn't a very practical way to input file filters, I need to write some interface for it before this can be used.
 
----
 
== Pseudo-Files ==
 
As part of the anime3 scripts I've developed a kind super file implementation, a bit like of [[Shadow_Files|Shadow Files]], i call them Pseudo-Files.  
What they are is simple, whenever there are [[Content:File_relations|File Relations]] involved i create a new file from all the data the relations give me. IE:
 
File A is a video file with the following attributes: ja audio, en subtitles.
File B is a subtitle file which adds de subtitles to File A.
 
Currently i gave users the option to expand files which have file<->file relations, so the file table for the Episode that holds File A and File B would look like this with all files expanded:
 
File A .......<br>
\- File B ....<br>
File B .......<br>
\- File A
 
With pseudo-files i create a new super-file that would have the following attributes ja audio, en and de subtitles, and it's representation is something like this, where File P is the Pseudo-File:
 
File P .......<br>
|- File A ....<br>
\- File B ....
 
Pseudo-files are also victim of file filters, so imagine some file would get hidden because it didn't have all the languages you wanted but a pseudo-file which was parent of that file had all the languages, the pseudo-file would not get hidden. In case it did fail the test it would get hidden.
 
This is the magic of pseudo-files. Another unused feature of show=anime3
 
== Notes ==
As you have noticed, any of the features referred here is ready to be used by normal users, it's like the ground work for future features. So if someone really wants this, bug me until I write an interface for them :P

Latest revision as of 10:17, 14 May 2009

New Anime Page Patterns and Usage

Implemented, official page at: PAGE_PREFERENCES_ED2K.

Custom filters for files

The new anime page supports custom filters for files. Currently there are 4 types of filters:

Deprecated
this filter marks files as deprecated
Unfiltered
this one checks which files don't get filtered
Visible
checks to see which files even if marked as to be hidden should be displayed
Hidden
hides files based on user preferences

The default rules for each filter follow the Deprecated files rules currently implemented in AniDB except for the Hidden filter that also hides files based on user profile language preferences.


Syntax and some rules

Filter Syntax:
Except for element "0", that states how many rules there are, elements follow this format:
"RULE NUMBER":{"RULE SUBJECT #1":"OPERATION,TEST";"RULE SUBJECT #2":"OPERATION,TEST"; etc};

Where RULE SUBJECT can be one of the following:

fdate
File add date
eusers
Total number of users for this episode
fusers
Total number of users for this file
fcrc
File CRC status (valid, invalid, unknown)
fqual
File quality
fgroup
File Group Id
fversion
File version
finmylist
File is in MyList
efvisible
Total number of files
falang
Any of the file audio languages is one of the preferred langs (if using obj.filterAudLang) or given lang
fslang
Any of the file audio languages is one of the preferred langs (if using obj.filterSubLang) or given lang
ftype
File type (generic)
fsource
File source (HDTV, DTV, etc)
fextension
File extension (mkv, avi, mov, etc)
fdeprecated
Is file deprecated
fraw
Is file RAW
fgroupfiltered
Is group filtered


Notes:

  • When RULE SUBJECT is prefixed with "c_sf_", there will be test of comparison for all files of the episode and the results of this comparison will be stored in processing Files
  • When RULE SUBJECT is prefixed with "c_rf_", there will be test of comparison for all files stored in processing Files, and the list will be updated with the results
  • No RULE SUBJECT prefixed with "c_" imply that you are testing an attribute, think of it as a SQL select where


OPERATION can be one of the following:

>
greater than
<
lesser than
>=
greater or equal than
<=
lesser or equal than
==
Equal to
!=
Not equal to


Where TEST is the value to test, there are special cases:

this
will test against the same RULE SUBJECT (only used in "c" prefixed RULE SUBJECTS)


Notes:

  • For each RULE NUMBER the RULE SUBJECTS are tested using AND
  • Will only test RULES until end or a failed test

Default Unfiltered

filterObj.defaultUnfiltered = {0:2,
                               1:{"fdate":"<,172800"},
                               2:{"ftype":"==,generic"}};

Default Deprecated

filterObj.defaultDeprecated = {0:5,
                            1:{"eusers":">=,50","fusers":"<=,3","fcrc":"!=,valid"},
                            2:{"fcrc":"==,invalid"},
                            3:{"fqual":">,1","fqual":"<=,5"},
                            4:{"c_sf_fgroup":"==,this","c_rf_fsource":"==,this","c_rf_fversion":"==,this","c_rf_fextension":"==,this","c_rf_fcrc":"==,valid","fcrc":"!=,valid","fgroup":"!=,0"},
                            5:{"c_sf_fgroup":"==,this","c_rf_fsource":"==,this","c_rf_fversion":">,this","c_rf_fextension":"==,this","c_rf_fcrc":"==,valid","fgroup":"!=,0"}}

Default Visible

filterObj.defaultVisible = {0:5,
                            1:{"fdeprecated":"==,true"},
                            2:{"finmylist":"==,true"},
                            3:{"fusers":">=,50"},
                            4:{"fdate":"<,604800"},
                            5:{"efvisible":"<,1"}};

Default Hidden

filterObj.defaultHidden = {0:2,
                           1:{"falang":"==,obj.filterAudLang"},
                           2:{"fslang":"==,obj.filterSubLang"}};

Example of usage

Imagine you had a fcen that would return true if a file is marked as censored, funcen that would return true if a file is marked as uncensored and a acen that would return true if the current anime has been marked as +18. Having this if you wanted to hide all censored files for a +18 anime and only leave uncensored or not marked files you would add this to the hidden filter.

filterObj.hidden = {0:1,
                    1:{"acen":"==,true","fcen":"==,true"}};

This filter would mark as hidden all censored files for a +18 anime.

Notes: obviously this isn't a very practical way to input file filters, I need to write some interface for it before this can be used.


Pseudo-Files

As part of the anime3 scripts I've developed a kind super file implementation, a bit like of Shadow Files, i call them Pseudo-Files. What they are is simple, whenever there are File Relations involved i create a new file from all the data the relations give me. IE:

File A is a video file with the following attributes: ja audio, en subtitles. File B is a subtitle file which adds de subtitles to File A.

Currently i gave users the option to expand files which have file<->file relations, so the file table for the Episode that holds File A and File B would look like this with all files expanded:

File A .......
\- File B ....
File B .......
\- File A

With pseudo-files i create a new super-file that would have the following attributes ja audio, en and de subtitles, and it's representation is something like this, where File P is the Pseudo-File:

File P .......
|- File A ....
\- File B ....

Pseudo-files are also victim of file filters, so imagine some file would get hidden because it didn't have all the languages you wanted but a pseudo-file which was parent of that file had all the languages, the pseudo-file would not get hidden. In case it did fail the test it would get hidden.

This is the magic of pseudo-files. Another unused feature of show=anime3

Notes

As you have noticed, any of the features referred here is ready to be used by normal users, it's like the ground work for future features. So if someone really wants this, bug me until I write an interface for them :P