Non puoi selezionare più di 25 argomenti Gli argomenti devono iniziare con una lettera o un numero, possono includere trattini ('-') e possono essere lunghi fino a 35 caratteri.
 
 
 
 
 
 

134 righe
2.9 KiB

  1. .TH img2txt 1 "2007-11-07" "libcaca"
  2. .SH NAME
  3. img2txt \- convert images to various text-based coloured files
  4. .SH SYNOPSIS
  5. .B img2txt
  6. [
  7. .B \-W
  8. .I width
  9. ]
  10. [
  11. .B \-H
  12. .I height
  13. ]
  14. [
  15. .B \-x
  16. .I font-width
  17. ]
  18. [
  19. .B \-y
  20. .I font-height
  21. ]
  22. .PD 0
  23. .IP
  24. .PD
  25. [
  26. .B \-b
  27. .I brightness
  28. ]
  29. [
  30. .B \-c
  31. .I contrast
  32. ]
  33. [
  34. .B \-g
  35. .I gamma
  36. ]
  37. .PD 0
  38. .IP
  39. .PD
  40. [
  41. .B \-d
  42. .I dither
  43. ]
  44. [
  45. .B \-f
  46. .I format
  47. ]
  48. .I FILE
  49. .RI
  50. .SH DESCRIPTION
  51. .B img2txt
  52. converts images to colour ASCII characters and outputs them to text-based
  53. coloured files.
  54. .PP
  55. .B img2txt
  56. can load the most widespread image formats: PNG, JPEG, GIF, PNG, BMP etc (see
  57. .B NOTES
  58. for details).
  59. By default the output text is 60 columns wide, and the line count is
  60. computed accordingly to respect aspect ratio of original file.
  61. The default output format is standard ANSI coloured text.
  62. .SH OPTIONS
  63. .TP
  64. .B \-W, \-\-width=<width>
  65. Change output column count. If not given, the default is set to 60.
  66. .TP
  67. .B \-H, \-\-height=<height>
  68. Change output line count. If not given, the height is computed to match correct aspect ratio.
  69. .TP
  70. .B \-x, \-\-font-width=<width>
  71. Change output font width. If not given, the default is set to 6. This value will be used for computing aspect ratio.
  72. .TP
  73. .B \-y, \-\-font-height=<height>
  74. Change output font height. If not given, the default is set to 10. This value will be used for computing aspect ratio.
  75. .TP
  76. .B \-b, \-\-brightness=<brightness>
  77. Change image brightness. Default to 1.0.
  78. .TP
  79. .B \-c, \-\-contrast=<contrast>
  80. Change image contrast. Default to 1.0.
  81. .TP
  82. .B \-g, \-\-gamma=<gamma>
  83. Change image gamma. Default to 1.0.
  84. .TP
  85. .B \-d, \-\-dither=<dither>
  86. Change dithering algorithm. This can be one of the following (default to fstein) :
  87. none : Nearest color
  88. ordered2 : Ordered 2x2
  89. ordered4 : Ordered 4x4
  90. ordered8 : Ordered 8x8
  91. random : Random
  92. fstein : Floyd Steinberg
  93. .TP
  94. .B \-f, \-\-format=<format>
  95. Change output format. This can be one of the following (default to ansi) :
  96. ansi : coloured ANSI
  97. caca : internal libcaca format
  98. utf8 : UTF8 with CR
  99. utf8 : UTF8 with CRLF (MS Windows)
  100. html : HTML with CSS and DIV support
  101. html3 : Pure HTML3 with tables
  102. irc : IRC with ctrl-k codes
  103. bbfr : BBCode (French)
  104. ps : Postscript
  105. svg : Scalable Vector Graphics
  106. tga : Targa Image
  107. .TP
  108. .B \-h, \-\-help
  109. Display help message and exit.
  110. .TP
  111. .B \-v, \-\-version
  112. Display version of the program and exit.
  113. .SH EXAMPLES
  114. img2txt hello.jpg > hello.ans
  115. img2txt \-\-width=40 \-\-format=svg hello.jpg > tinyhello.svg
  116. .SH NOTES
  117. Setting both column and line count (using
  118. \-\-width
  119. and
  120. \-\-height) will let you choose the exact output size without taking aspect ratio in account.
  121. You must compile libcaca package with support of
  122. .I Imlib2
  123. to be able to load a wide variety of image formats. Otherwise you will only be able to load regular BMP files.
  124. .SH SEE ALSO
  125. cacaview(1)
  126. .SH AUTHOR
  127. This manual page was written by Sam Hocevar <sam@zoy.org> and Jean-Yves Lamoureux <jylam@lnxscene.org>.