查看“CameraObscura”的源代码

=介绍=
CameraObscura可以给你的世界带来摄影和图片.你可以使用相机来拍照,或是查看图片.
=特点=
* 用相机拍照 (三种照片: 全身照, 半身照, 头像)
* 用三脚架相机拍摄照片,支持经济插件 (玩家必须付费拍照)
* 创建png格式的图片
* 创建由彩色羊毛组成的像素风格图片
* 拥有版权保护的图片
* 照片所有者特点: 限制每个人的照片数, 版权保护, 改变照片所有权.
* 移除照片
* 相机和胶卷合成配方, 创建三脚架相机不需要指令.
=用法=
* 安装插件
* 配置插件 (编辑config.yml)
* 上传一些背景 (推荐尺寸:128x128), 上传图片到插件文件夹内.
==如何创建图片==
# 使用 "相机" 来拍照,  并且需要一张胶卷 (默认卷轴的材质是一张纸片: 你不能用普通的纸来拍照). 用相机右键一个玩家,一张胶卷就会被消耗并成为照片.
# 三脚架相机. 你必须建造一个三脚架.放置熔炉, 音符盒, 和... camera at the side of note block. Than take a photo paper and click to button (camera lens). Note: Both cameras supported three types of photos defined by distance from camera to player: head photo, top-half photo, full length photo. All photos are printed on the background. Backgrounds are png-images uploaded to specified folder (/CameraObscura/backgrounds/). Camera obscura can be configured to use any predefined background.
# Create photo of any player (even offline player) using commands. Hold one sheet of photo paper in hand and type commands: /photo head <player name>, /photo top <player name>, * /photo full <player name>
# Create a picture based on image file. You need to upload image (only png-file supported now) to /CameraObscura/images/ folder and type /photo image <image name>
# Create a picture based on colored wool pixel-art, You need to create a picture using colored wool. Type /photo brush to enable brush mode. Left clicking with brush (feather item) will select 1st point (top left!), right clicking will select 2nd point (bottom right). Type command:
* /photo paint <picture_name> to create a picture resized to 128x128
* /photo paint center <picture_name> to create a picture and place it at center of the map. Picture will not be resized so it could be too little... Note: you can repaint previously created picture using command /photo repaint {center} <picture_name> (don't forget to hold in hand picture that you need to repaint)
==如何创建三脚架相机==
=指令=
* /photo help [command] - 帮助页面
* /photo camera - 给予你一个相机
* /photo paper [amount] - 给予你一个胶卷
* /photo brush - 开关笔刷模式
* /photo list [page] [name mask] - 显示照片列表
* /photo files [page] [filename mask] - 显示文件列表 (图片)
* /photo download <name> <url> - download picture from <url> and save it with name <name> at images folder (not fully tested)
* /photo remove <id> - remove picture with defined id
* /photo rename <id> <new name> - rename picture
* /photo allowcopy [id] - toggles copy mode for picture
* /photo owner [id] <new owner> - set new owner for defined picture
* /photo head [player] - create a head-shot photo
* /photo top [player] - create a top-half photo
* /photo full [player] - create a full-length photo
* /photo image <filename> - create a new picture using image
* /photo image <filename> <dimension|auto> - create a large picture using image file. For example: /photo image image.jpg 3x4 will create a large picture that contains 3 rows and 4 columns of maps (totally 12 pictures (map items))
* /photo paint {center} <name> - paint a pixel-art picture, resized to 128x128
* /photo repaint {center} <name> - paint a pixel-art picture at the center of map (not resized)
* /photo id - show information about map in your hands
* /photo give <picture id> - gives a picture with defined id to you
* /photo reload - reload configuration
* /photo rst [player] - repaint pictures
* /photo cfg - displays configuration
=权限=
camera-obscura.config - allows to use basic commands
camera-obscura.givecamera - allows to use command /photo camera to give camera to player
camera-obscura.givepaper - allows to use command /photo paper to give photo paper to player
camera-obscura.pixelart - allows to use command /photo paint to create a picture based on the colored wool pixel-art
camera-obscura.remove - allows to use command /photo remove
camera-obscura.rename - allows to use command /photo rename
camera-obscura.allowcopy - allows to use command /photo allowcopy
camera-obscura.owner - allows to use command /photo allowcopy
camera-obscura.owner.all - player with this permission is "owner of all pictures (maps)" (he can remove, repaint and rename pictures created by other players)
camera-obscura.photo - allows to use commands /photo head, /photo top, /photo full
camera-obscura.image - allows to use command /photo image
camera-obscura.image.large - allows to create large pictures using command /photo image <filename> <dimension|auto>
camera-obscura.repaint - allows to use commands /photo repaint
camera-obscura.handy.use - allows to use photo camera
camera-obscura.tripod-camera.use - allows to use tripod camera
camera-obscura.set-sign - allows to set configuration sign for tripod-cameras
camera-obscura.tripod-camera.build - allows to build tripod-cameras
camera-obscura.fireproof-wool - if player has this permission wool will not burn after painting picture
camera-obscura.files - allows to use command /photo files
camera-obscura.files.autocreate - enable personal folder autocreation (requires enabled personal-folders in config.yml)
camera-obscura.files.all - allows to use command /photo files p:<player name> to list personal folder content of any player
=配置=
 general:
   check-updates: true  # Check updated version of Camera Obscura
   language: english  # Language. By default supported english and russian
   language-save: false # Save language file
 items:
 # Brush used to select wool-painting. Default: feather item
   brush-id: 288
 # Photo paper used everytime when you creating a picture or photo. Default: PAPER:1
   photo-paper:
     id: 339
     data: 1
 # Photo camera used to develop a photo or build a tripod camera. Default: WATCH:1
   photo-camera:
     id: 347
     data: 1
 # Enable build-in recipces. If you need to use other recipe manager set this variable to false
   use-recipes: true
 # If set to true - tripod camera's button (lens) will turned to photo camera when breaking
   obscura-drop: true
 pictures:
 # Deleted image will be used when you creating new ones.
   reuse-deleted-maps: true
 # Wool pictures with sizes lesser than this values will be not printed at pictures
   minimal-pixel-art-size: 16
 # Default backgrounds. Random - will be select on file from the background folder randomly
   default-background: random
 # Picture limit. If player reach it (create 15 photoes) he must delete picture to create new
   pictures-per-owner: 15
 # Burn wool after painting picture
   burn-pixel-art-wool: true
 # You can save any skin at /skins/ directory - this skin will be used if player has now skin or if skin was not downloaded from the server
   default-skin: default_skin.png
 # Skin will be downloaded from here:
   skin-url: http://s3.amazonaws.com/MinecraftSkins/
 
 # Configure displaying of picture name
 picture-name:
 # Default state of show/hide picture names for new images
   show-at-new-pictures: true
 # x,y - coordinages for picture name (at canvas)
   x: 1
   y: 122
 # Font name (must be installed in system)
   font-name: Serif
 # Font size
   font-size: 9
 # Font color
   font-color: '#000000'
 # Enable stroke (outline picture name)
   stroke: true
 # Stroke color
   stroke_color: '#FFFFFF'