Mistakes in the user guide
Re: Mistakes in the user guide
On https://www.tvpaint.com/doc/tvp11/index.php?lang=en , chapter 5 is called "Tra*gidi*tal Animation: Advanced functions".
Quicktime is DEAD. Get over it and move on !
Re: Mistakes in the user guide
Should be fixed :p
Si votre question a trouvé réponse, marquez votre sujet comme Résolu.
If your question has been answered, mark your topic as Solved.
If your question has been answered, mark your topic as Solved.
- D.T. Nethery
- Posts: 4146
- Joined: 27 Sep 2006, 19:19
Re: Mistakes in the user guide
This is not a mistake as such , but a suggestion to add additional information.
I am glad to see the section in the User Manual on Video Input has been updated:
https://www.tvpaint.com/doc/tvp11/index ... ideo-input
My suggestion is that a few words might be added to the user manual page on Video Input regarding the information in this thread:
viewtopic.php?f=26&t=12019
The SparkoCam software I recommended for connecting Canon and Nikon DSLR's to TVPaint at 1920 x 1080 resolution.
and even better, the Elgato Cam Link 4k connector that David Meslin recommends here: viewtopic.php?f=26&t=12019#p121952 which can connect HD video cameras and DSLR cameras at up to 3840 x 2160 resolution.
These options allow the user to connect their DSLR camera or HD video camera , not limited to the use of WDM webcams, in TVPaint for stop-motion animation frame capture or to shoot traditional line tests of animation drawn on paper.
.
I am glad to see the section in the User Manual on Video Input has been updated:
https://www.tvpaint.com/doc/tvp11/index ... ideo-input
My suggestion is that a few words might be added to the user manual page on Video Input regarding the information in this thread:
viewtopic.php?f=26&t=12019
The SparkoCam software I recommended for connecting Canon and Nikon DSLR's to TVPaint at 1920 x 1080 resolution.
and even better, the Elgato Cam Link 4k connector that David Meslin recommends here: viewtopic.php?f=26&t=12019#p121952 which can connect HD video cameras and DSLR cameras at up to 3840 x 2160 resolution.
These options allow the user to connect their DSLR camera or HD video camera , not limited to the use of WDM webcams, in TVPaint for stop-motion animation frame capture or to shoot traditional line tests of animation drawn on paper.
.
Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MacOS 12.7.1 Monterey , Mac Mini (2018) , 3.2 GHz 6-Core Intel Core i7,
16 GB RAM , TVPaint PRO 11.7.1 - 64bit , Wacom Cintiq 21UX 2nd Gen.
,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1
- D.T. Nethery
- Posts: 4146
- Joined: 27 Sep 2006, 19:19
Re: Mistakes in the user guide
EDIT: as of March 1, 2021 , this has now been fixed .
-------
I notice that this part of the User Manual still contains mistaken/non-standard terminology referring to the Multiplane Camera :
https://www.tvpaint.com/doc/tvp11/index ... ra-concept
It says:
A better way of phrasing this would be:
Just to be clear, this is an editing table, made by companies such as Steenbeck or KEM.
Or an older style Editing Table (editing bench) with a small Movieola viewer and film reels with rewind cranks, where film is viewed and spliced together by an editor.
Neither of these type of editing tables has any relation to a multiplane rostrum camera stand used for shooting animation.
-------
I notice that this part of the User Manual still contains mistaken/non-standard terminology referring to the Multiplane Camera :
https://www.tvpaint.com/doc/tvp11/index ... ra-concept
It says:
I have never seen a multiplane camera referred to as an "editing table".Editing table and computer multiplane camera -
Below on the left you will see the schematic diagram of a traditional multiplane camera setup often referred to as editing table. Each plane is placed on a sheet of glass and is moved progressively while filming.
Our computer multi plane camera effect, seen below right, does not function in the same way:
In this case, it is the camera which moves progressively while filming and the scenery is automatically duplicated horizontally (the starry sky background does not move and is always placed in front of the virtual camera).
A better way of phrasing this would be:
Traditional multiplane rostrum camera compared to virtual computer multiplane camera -
"Below on the left you will see a schematic diagram of a traditional multiplane rostrum camera setup . Each plane of artwork is placed on a sheet of glass mounted in moveable metal or wooden frames and moved progressively at different rates of speed under the camera to produce the illusion of depth."
Just to be clear, this is an editing table, made by companies such as Steenbeck or KEM.
Or an older style Editing Table (editing bench) with a small Movieola viewer and film reels with rewind cranks, where film is viewed and spliced together by an editor.
Neither of these type of editing tables has any relation to a multiplane rostrum camera stand used for shooting animation.
Last edited by D.T. Nethery on 01 Mar 2021, 18:04, edited 1 time in total.
Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MacOS 12.7.1 Monterey , Mac Mini (2018) , 3.2 GHz 6-Core Intel Core i7,
16 GB RAM , TVPaint PRO 11.7.1 - 64bit , Wacom Cintiq 21UX 2nd Gen.
,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1
Re: Mistakes in the user guide
Hi!
I’m Matthieu. I’ve recently joined the team so this is my first time posting here![Smile :)](./images/smilies/icon_smile.gif)
Thank you very much for noticing this and for your suggestions. We will update the user guide accordingly.
I’m Matthieu. I’ve recently joined the team so this is my first time posting here
![Smile :)](./images/smilies/icon_smile.gif)
Thank you very much for noticing this and for your suggestions. We will update the user guide accordingly.
Re: Mistakes in the user guide
Welcome aboard! The more the merrier!
sven
TVP Pro 11.0.10-64bit Win10 - 64GB ram -2TB HHD - 256GB SSD - Wacom Cintiq 16, driver 6.3.41-1
Android Tablet: rel. 11, Samsung Galaxy Note10.1 - 32GB with microSD 32GB
Android Tablet: rel. 11.5, Samsung Galaxy Tab S7plus - 128GB with microSD 64GB
Android Tablet: rel. 11, Samsung Galaxy Note10.1 - 32GB with microSD 32GB
Android Tablet: rel. 11.5, Samsung Galaxy Tab S7plus - 128GB with microSD 64GB
Re: Mistakes in the user guide
- Paul Fierlinger
- Posts: 8100
- Joined: 03 May 2008, 12:05
- Location: Pennsylvania USA
- Contact:
Re: Mistakes in the user guide
Hi Matthieu
Below it says I'm here with 101 others. It's good to see and more so with a new site administrator.
Below it says I'm here with 101 others. It's good to see and more so with a new site administrator.
Paul
http://www.slocumfilm.com
Desktop PC Win10-Pro -64 bit OS; 32.0 GB RAM
Processor: i7-2600 CPU@3.40GHz
AMD FirePro V7900; Intuos4 Wacom tablet
http://www.slocumfilm.com
Desktop PC Win10-Pro -64 bit OS; 32.0 GB RAM
Processor: i7-2600 CPU@3.40GHz
AMD FirePro V7900; Intuos4 Wacom tablet
Re: Mistakes in the user guide
Welcome! Happy to have you! :D
Windows 10 64-bit | AMD Ryzen 9 5950x | TVPaint Animation 11 Pro WIBU (11.7.1-64 bits) | Wacom Cintiq Pro 27
Re: Mistakes in the user guide
Thanks for the kind words ![Smile :)](./images/smilies/icon_smile.gif)
![Smile :)](./images/smilies/icon_smile.gif)
- D.T. Nethery
- Posts: 4146
- Joined: 27 Sep 2006, 19:19
Re: Mistakes in the user guide
This page in the user guide has some potentially confusing information for the new user trying to learn TVPaint : https://www.tvpaint.com/doc/tvp11/index ... -instances
At the bottom of the page it says: "You can also use the shortcut [H] and [J] to flip your animation respectively backwards or forwards. We will see these notions in lesson 05."
BUT in TVPaint 11.5 I think the default shortcuts do not have H or J assigned to Go To Previous Instance or Go to Next Instance. Default shortcut for Go To Previous Instance is CMD Left and Go to Next Instance is CMD Right, not H or J. In the default shortcuts for 11.5 I don't think H or J are assigned to any function, so the mention of using shortcut H and J to flip your animation backwards or forwards is confusing.
.
At the bottom of the page it says: "You can also use the shortcut [H] and [J] to flip your animation respectively backwards or forwards. We will see these notions in lesson 05."
BUT in TVPaint 11.5 I think the default shortcuts do not have H or J assigned to Go To Previous Instance or Go to Next Instance. Default shortcut for Go To Previous Instance is CMD Left and Go to Next Instance is CMD Right, not H or J. In the default shortcuts for 11.5 I don't think H or J are assigned to any function, so the mention of using shortcut H and J to flip your animation backwards or forwards is confusing.
.
Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MacOS 12.7.1 Monterey , Mac Mini (2018) , 3.2 GHz 6-Core Intel Core i7,
16 GB RAM , TVPaint PRO 11.7.1 - 64bit , Wacom Cintiq 21UX 2nd Gen.
,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1
Re: Mistakes in the user guide
Hello David,
Thank you for noticing this! It's indeed confusing. We'll update the documentation accordingly.
Thank you for noticing this! It's indeed confusing. We'll update the documentation accordingly.
- D.T. Nethery
- Posts: 4146
- Joined: 27 Sep 2006, 19:19
Re: Mistakes in the user guide
These are not mistakes as such, but some suggested improvements for clarity.
This page on Exporting Files from TVPaint: https://www.tvpaint.com/doc/tvp11/index ... cts-export
could use some editing to omit reference to Quicktime (no longer used , replaced by FFMpeg) and some clarification of certain points .
"The option File > Export project to... is used to convert your project into a format of your choice: animated GIF, AVI or QuickTime file, numbered frames sequence, etc."
BUT I also suggest a change to this sentence:
The reference to "Quicktime file" should be omitted because TVPaint has moved away from using Quicktime for export to MOV , in favor of using FFMpeg. Further, I would suggest that "numbered frames sequence" would be better as: "numbered image sequence in commonly used image formats such as PNG, JPG, TIF, etc.".
I would suggest that the sentence should be written as:
"The option File > Export project to... is used to convert your TVPaint project into a format of your choice: animated MOV, MP4, AVI , GIF , or a numbered image sequence in commonly used image formats such as PNG, JPG, TIF, etc."
--------
This paragraph:
Also remove the reference to "quicktime" file format in this sentence: "is available for some file formats (deep, gif, quicktime, fli, avi)." I would suggest changing that to:
"is available for some file formats (MOV, MP4, AVI, GIF, DEEP." .
-----
Regarding this tip that appears in the above paragraph:
I think the wording "Including a "0" in your file name may help with numbering your images." gives the impression that this is optional , but in my experience it is necessary to include "0" or "00" preceding the numbers in the image sequence so that the image sequence will remain in the correct order when imported into applications such as Adobe Premiere or After Effects. I would suggest changing it to remove the ambiguous words "may help" , to read more decisively as:
"Including a "00" in the name of your exported image sequence will keep the image sequence arranged in the correct order when importing the image sequence into other applications, such as video editing software. For example , when exporting an image sequence of 354 images if the first file name in an image sequence is "ImageName_0001", the image sequence will have the names ImageName_0001.png , ImageName_0002.png , ImageName_0003.png ... ImageName_0354.png ."
-----
Under PROJECT and CLIP tabs, this sentence:
"The second section deals with the export file formats: TVPaint Animation allows you to export your projects in a wide variety of formats: PSD , AVI, MOV, MP4 ,GIF, PNG, JPG, TGA, TIFF, BMP, DPX, DEEP,FLI, PCX, SUNRASTER, ILBM."
(note: in addition to removing the reference to "QUICKTIME" , this also lists the available image formats with the more commonly used formats listed first , with the more obscure formats such as DPX, DEEP, FLI , PCX ,SUNRASTAR, ILBM listed after the more common formats.)
-----
➔ I'm not sure exactly where , but somewhere in this section of the User Manual concerning Export options it should be mentioned as a note to Mac users that a file exported as MP4 (FFMpeg) LOSSLESS PNG will not play in Apple Quicktime Player, but will play in alternative video players such as VLC, Elmedia, or MPEG Streamclip. Because Quicktime player is still the default video player for macOS this can lead to frustration if a Mac user attempts to export to MP4 (FFMpeg) LOSSLESS PNG , because files in that format will not play in Quicktime player. The other two options for exporting to MP4 - MP4 (FFMpeg) Compressed H.264 or MP4 (FFMpeg) Compressed MPEG-4 will play in Quicktime player , but not the option MP4 (FFMpeg) LOSSLESS PNG.
----
➔ I think the provided video tutorial could stand to be updated (or amended) to better explain the export options of "Mark In/Mark Out" vs "Full Range" , and the option to export to MP4 format.
Another short video tutorial simply demonstrating the basic export function of an animation project in TVPaint to video formats AVI , MOV, MP4 would be helpful.
This page on Exporting Files from TVPaint: https://www.tvpaint.com/doc/tvp11/index ... cts-export
could use some editing to omit reference to Quicktime (no longer used , replaced by FFMpeg) and some clarification of certain points .
I suggest that the first, second and third sentences above are not necessary to explain that TVPaint files tend to be large and to give a reason for exporting a project from TVPaint: "Even if it contains specific data relative to your project (opacity, layers, etc…), the TVP format is not a practical solution if you want to share it with your friends at parties or on a website. Use of the dependencies function will render your project smaller, but it is not more practical in the aforementioned cases." because it is unlikely that anyone wants to post a .tvpp file to play on their website (which not possible) or to "share with friends at parties". I think the first , second , and third sentences are redundant or irrelevant to the subject of Exporting. I think this page of the User Guide would be better to simply start from the fourth sentence:"Saving a project in TVPaint Animation format with all associated layers may require a considerable amount of storage capacity.
Even if it contains specific data relative to your project (opacity, layers, etc…), the TVP format is not a practical solution if you want to share it with your friends at parties or on a website. Use of the dependencies function will render your project smaller, but it is not more practical in the aforementioned cases.
The option File > Export project to... is used to convert your project into a format of your choice: animated GIF, AVI or QuickTime file, numbered frames sequence, etc. You will find this very practical as you are able to save your work in smaller files."
"The option File > Export project to... is used to convert your project into a format of your choice: animated GIF, AVI or QuickTime file, numbered frames sequence, etc."
BUT I also suggest a change to this sentence:
The reference to "Quicktime file" should be omitted because TVPaint has moved away from using Quicktime for export to MOV , in favor of using FFMpeg. Further, I would suggest that "numbered frames sequence" would be better as: "numbered image sequence in commonly used image formats such as PNG, JPG, TIF, etc.".
I would suggest that the sentence should be written as:
"The option File > Export project to... is used to convert your TVPaint project into a format of your choice: animated MOV, MP4, AVI , GIF , or a numbered image sequence in commonly used image formats such as PNG, JPG, TIF, etc."
--------
This paragraph:
needs to be updated for TVPaint 11.5 export options to explain how to set the export according to Mark In and Mark Out points compared to the option Full Range, which is now the default. (but the "Full Range" option vs. Mark In/Mark Out is not mentioned in the current version of the user manual.)- As allows you to choose the kind of export you want :
• Single image (save the image visible in the right section of the panel only),
• Sequence (save, frame per frame, the images located between the Mark in and Mark out points-. By default, the images are numbered as follows: file_name_1, file_name_2, … … … file_name_123, … Sequence becomes Animation when exporting in a video format.
• Animation is used to save all the frames between the Mark in and Mark out points in a single file and is available for some file formats (deep, gif, quicktime, fli, avi).
Also remove the reference to "quicktime" file format in this sentence: "is available for some file formats (deep, gif, quicktime, fli, avi)." I would suggest changing that to:
"is available for some file formats (MOV, MP4, AVI, GIF, DEEP." .
-----
Regarding this tip that appears in the above paragraph:
I think the wording "Including a "0" in your file name may help with numbering your images." gives the impression that this is optional , but in my experience it is necessary to include "0" or "00" preceding the numbers in the image sequence so that the image sequence will remain in the correct order when imported into applications such as Adobe Premiere or After Effects. I would suggest changing it to remove the ambiguous words "may help" , to read more decisively as:
"Including a "00" in the name of your exported image sequence will keep the image sequence arranged in the correct order when importing the image sequence into other applications, such as video editing software. For example , when exporting an image sequence of 354 images if the first file name in an image sequence is "ImageName_0001", the image sequence will have the names ImageName_0001.png , ImageName_0002.png , ImageName_0003.png ... ImageName_0354.png ."
-----
Under PROJECT and CLIP tabs, this sentence:
should remove the reference to QUICKTIME as an available file format. I suggest the sentence should read as:"The second section deals with the export file formats: TVPaint Animation allows you to export your projects in a wide variety of formats: DIP, AVI, GIF, BMP, QUICKTIME, DPX, FLI, PNG, PCX, SUNRASTER, PSD, TGA, JPG, ILBM, TIFF."
"The second section deals with the export file formats: TVPaint Animation allows you to export your projects in a wide variety of formats: PSD , AVI, MOV, MP4 ,GIF, PNG, JPG, TGA, TIFF, BMP, DPX, DEEP,FLI, PCX, SUNRASTER, ILBM."
(note: in addition to removing the reference to "QUICKTIME" , this also lists the available image formats with the more commonly used formats listed first , with the more obscure formats such as DPX, DEEP, FLI , PCX ,SUNRASTAR, ILBM listed after the more common formats.)
-----
➔ I'm not sure exactly where , but somewhere in this section of the User Manual concerning Export options it should be mentioned as a note to Mac users that a file exported as MP4 (FFMpeg) LOSSLESS PNG will not play in Apple Quicktime Player, but will play in alternative video players such as VLC, Elmedia, or MPEG Streamclip. Because Quicktime player is still the default video player for macOS this can lead to frustration if a Mac user attempts to export to MP4 (FFMpeg) LOSSLESS PNG , because files in that format will not play in Quicktime player. The other two options for exporting to MP4 - MP4 (FFMpeg) Compressed H.264 or MP4 (FFMpeg) Compressed MPEG-4 will play in Quicktime player , but not the option MP4 (FFMpeg) LOSSLESS PNG.
----
➔ I think the provided video tutorial could stand to be updated (or amended) to better explain the export options of "Mark In/Mark Out" vs "Full Range" , and the option to export to MP4 format.
Another short video tutorial simply demonstrating the basic export function of an animation project in TVPaint to video formats AVI , MOV, MP4 would be helpful.
Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MacOS 12.7.1 Monterey , Mac Mini (2018) , 3.2 GHz 6-Core Intel Core i7,
16 GB RAM , TVPaint PRO 11.7.1 - 64bit , Wacom Cintiq 21UX 2nd Gen.
,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1
- D.T. Nethery
- Posts: 4146
- Joined: 27 Sep 2006, 19:19
Re: Mistakes in the user guide
An addition to my suggestions posted above regarding Exporting from TVPaint.
Regarding the AfterEffects Import TVPaint JSON.jsx script : https://www.tvpaint.com/doc/tvp11/index ... xport-json
For some time now it has been the case that this JSON script will only work when it is run from the Default workspace of After Effects. (at least this is my experience with running the JSON script on macOS . I don't know if it's different running it on Windows, but I'm sure some simple tests could confirm). After the import to AE has been accomplished in the Default workspace the user may switch to using any other workspace in After Effects. I believe this important bit of information should be included in the user guide and also as a "Read Me" .txt file included in the download file so users are aware that the AfterEffects Import TVPaint JSON.jsx script must be run from AE's Default workspace.
.
Regarding the AfterEffects Import TVPaint JSON.jsx script : https://www.tvpaint.com/doc/tvp11/index ... xport-json
For some time now it has been the case that this JSON script will only work when it is run from the Default workspace of After Effects. (at least this is my experience with running the JSON script on macOS . I don't know if it's different running it on Windows, but I'm sure some simple tests could confirm). After the import to AE has been accomplished in the Default workspace the user may switch to using any other workspace in After Effects. I believe this important bit of information should be included in the user guide and also as a "Read Me" .txt file included in the download file so users are aware that the AfterEffects Import TVPaint JSON.jsx script must be run from AE's Default workspace.
.
Animator, TVPaint Beta-Tester, Animation Educator and Consultant.
MacOS 12.7.1 Monterey , Mac Mini (2018) , 3.2 GHz 6-Core Intel Core i7,
16 GB RAM , TVPaint PRO 11.7.1 - 64bit , Wacom Cintiq 21UX 2nd Gen.
,Wacom Intuos Pro 5 , Wacom driver version 6.3.39-1
Re: Mistakes in the user guide
Hello David,
Thank you very much for your suggestions. I will make changes in the documentation to make things clearer.
Thank you very much for your suggestions. I will make changes in the documentation to make things clearer.