ImageWaterMark3.0技术开发手册.doc

.cn 中国企业互联网产品应用和网络品牌营销提供商!ImageWaterMark3.0技术开发手册ImageWaterMark3.0缩略图水印组件是基于Asp.Net2.0 C#.Net WebForm而开发的全功能组件，无需再服务器端安装AspJpeg组件，它的技术特点目前版本新增加了透明浮雕功能、水印平铺等，目前也是国内唯一支持透明浮雕的处理。1 功能介绍文字水印、Logo水印、文字水印阴影、文字水印描边、浮雕文字、雕刻文字、立体文字、水印平铺、水印透明度、图片裁剪、马赛克处理、图像对比度、图像亮度、图像颜色调整。2 详细参数说明SourceImagePath：（数组类型）指定原图路径（详细使用请参考演示实例）；WaterMarkText：（String类型）水印文字；TextFont：（String类型）字体；TextColor：（String类型）文字颜色；TextSize ：（String类型）字号；Vertical ：（Bool类型）文字纵向排列（只对普通文本有效）（True）TextShadow ：（Bool类型）是否开启文字阴影；TextShadowColor：（String类型）阴影颜色； TxTShadowTransparence：（Int类型）阴影透明度（最大值100）,同时影响文字边线和立体文字侧面； TextShadowDepthX ：（Int类型）阴影深度X坐标点位置；TextShadowDepthY：（Int类型）阴影深度Y坐标点位置；WaterMarkTextStyle：（WaterMark.TextStyle类型）水印文字样式，其中有传统的文字加粗、斜体、下划线、中划线等；（WaterMark.WaterMarkType：设置水印类型，参数WaterMark.WaterMarkType.Text为文字水印，WaterMark.WaterMarkType.Logo为Logo图片水印。禁用水印则设置为WaterMark.WaterMarkType.None即可。）；WaterMarkTransparence：（Int类型）水印透明度（仅对浮雕效果无效）；WaterMarkAngle：（Int类型）水印旋转角度；WaterMarkPlaceX：（Int类型）自定义水印位置X坐标；WaterMarkPlaceY：（Int类型）自定义水印位置Y坐标；WaterMarkAlign：（WaterMark.WaterMarkAlignMode类型）自动控制水印固定在图像上的显示方式，共提供九种方式（左上角、左下角、居中、右上角、右下角、顶部居中、底部居中、左边居中、右边居中）WaterMarkTextEffect：（WaterMark.TextType类型）水印文字类型，分别有四种效果（TextType.DrawBound描边文字、TextType.TextSolid立体文字、TextType.TextEmBoss浮雕文字、TextType.Ordinary（默认值）普通文字等）EmBossOffsetMode：（WaterMark.EmBossOffset类型）浮雕视觉偏移方向提供四种方式（左上角、右上角、左下角、右下角），根据原图的光照效果调整效果更佳。SolidOffsetMode：（WaterMark.SolidOffset类型）立体视觉偏移方向提供四种方式（左上角、右上角、左下角、右下角），根据原图的光照效果调整效果更佳。EmBossStyle：（WaterMark.TextEmBossStyle类型）设置浮雕样式，提供三种效果（TextEmBossStyle.Engrave雕刻浮雕，TextEmBossStyle.Hollow空心浮雕，TextEmBossStyle.Convexity凸面浮雕）EmBossReinfor：（Bool类型）浮雕效果加强；SolidFretwork：（Bool类型）镂空立体文字；SolidDepth：（Int类型）立体侧面深度 （范围值530）；SolidDensity：（Int类型）立体侧面密集度（范围值14）；TextBorderWidth：（Int类型）描边文字边线宽度；TextBorderColor：（String类型）描边文字边线颜色；MiniatureImagePath：（String类型）指定缩略图存放路径，不配置为原图路径；SaveWaterMarkImagePath：（String类型）设置保存生成图像的路径，不配置为原图路径；ImageQuality：（Int类型）设置生成图像的质量，质量越高生成的图像越大；DelSourceImg：（Bool类型）是否删除原图；WaterMarkTile：（Bool类型）水印平铺，仅对普通文字水印和Logo水印有效；VerticalSpace：（Int类型）设置平铺列间距；LineSpace：（Int类型）设置平铺行间距；ImageBorder：（Bool类型）给图像添加边框；ImageBorderColor：（）图像边线颜色；ImageBorderWidth：（Int类型）图像边线宽度；ImageBorderTransparence：（Int类型）图像边线透明度；WaterMarkImagePath：（String类型）指定水印Logo路径；WaterMarkImageGroundColor：（String类型）设置过滤Logo图片背景颜色；ImgType：（WaterMark.ImageType类型）手动指定生成图像类型，默认为原图类型；WaterMarkTileMode：（WaterMark.TiledMode类型）设置水印平铺方式，提供两种方式（水平对齐和水平错位）；Wfpath：（String类型）返回生成图像路径；Mfpath：（String类型）返回缩略图路径；WbatchPath：（String类型）返回批量处理所有生成图像路径，只有批处理时才有效，详细使用方法请参考演示实例；MbatchPath：（String类型）返回批量处理所有缩略图像路径，只有批处理时才有效，详细使用方法请参考演示实例；GetToWaterMarkImage（参数1，参数2，参数3，参数4，参数5，参数6，参数，7参数8）：执行生成操作处理； 参数1：水印类型；参数2：设置图片宽度；参数3：设置图片高度；参数4：是否同时生成缩略图；参数5：缩略图宽度；参数6：缩略图高度；参数7：是否执行裁剪（Bool类型）；参数8：是否执行马赛克处理（Bool类型）。SetImgEffect：（WaterMark.ImageEffect类型）图像效果处理方式，提供5种方式，分别：（ImageEffect.Monochrome：转换为黑白效果，ImageEffect.Negative：转换为负片效果，ImageEffect.Brightness：调整图像的亮度，ImageEffect.Contrast：调整图像的对比度，ImageEffect.RGBValue：调整图像的RGB颜色值Rvalue：红色值，Gvalue：绿色值，Bvalue：绿色值取值范围（-255255）ImageRotate： （WaterMark.RotateFlip类型）设置图像的旋转或翻转；提供6种旋转方式，分别：RotateFlip.Clockwise90：顺时针旋转90度，RotateFlip.Anticlockwise90：逆时针旋转90度，RotateFlip.Rotate180：水平旋转180度，RotateFlip.FlipX：水平翻转，RotateFlip.FlipY垂直翻转，RotateFlip.FlipXY：水平垂直翻转。CutX：（Int类型）裁剪起始位置X坐标；CutY：（Int类型）裁剪起始位置Y坐标；CutWidth：（Int类型）裁剪宽度；CutHeight：（Int类型）裁剪高度；MosGranule：（Int类型）设置马赛克颗粒大小；MosX：（Int类型）马赛克起始位置X坐标；MosY：（Int类型）马赛克起始位置Y坐标；MosWidth：（Int类型）马赛克范围宽度；MosHeight：（Int类型）马赛克范围高度；WaterMarkOverflow：（Bool类型）是否锁定水印在图像范围内，为False时自定义坐标可以为负数；ImgWidth：（Int类型）返回生成水印图像的宽度；ImgHeight：（Int类型）返回生成水印图像的高度；ImgSize：（Int类型）返回生成水印图像的大小；ImageOnlyCollect(string ImgUrl, string SavePath)：远程采集单张图片；ImageBatchCollect(string HttpUrl, string ImgType, string SavePath)：远程批量采集图片；MBSN()：（String类型）这个函数是返回服务器全球唯一标识，组件注册为服务器许可时用到；注：以上参数SourceImagePath采用的是数组类型，为了方便开发者做批量处理的时候无需在外部指定批处理操作，只需要赋值一组原图地址即可，组件内部会自动做相应的处理；3 调用方式在C#中引用using ImageWaterMark;命名空间，实例化WaterMark wm = new WaterMark();4 结语ImageWaterMark3.0缩略图水印组件注册方式：绑定域名（支持N个二级域名）或绑定服务器；注册后用户只需要将ImageWaterMark.lic许可文件放入Bin文件夹中即可。如果您是升级用户