网易云信 高分屏功能升级说明

云信高分屏功能简介

高分屏简单来说就是高分辨率屏幕，分辨率越高则显示器上单位面积显示的像素点越多，所以分辨率越大，则显示器显示的内容就越小、越多。近几年高分屏设备越来越普及，新一代笔记本几乎都是高分屏，最新版本的操作系统也都加强了对高分屏的支持。但与此同时也有个麻烦的问题，就是由于分辨率太高导致显示的内容很小，进而操作起来会比较麻烦，这点在平板电脑上尤为显著。

为了解决这个问题，我们可以设置系统DPI缩放比例。在Windows系统的控制面板里修改缩放比例来放大系统整体界面，这样我们就可以得到放大后的界面效果。

设置了DPI之后，如果我们的程序没有自己处理DPI缩放信息，则系统会自动帮助我们根据DPI来缩放程序。但是系统的缩放，实际就是获取程序原本尺寸的位图，然后根据DPI放大后显示出来，所以就会导致放大后的效果比较模糊。而如果我们的程序可以自己处理DPI缩放信息，系统就不会自动管理我们的程序，程序内部自己根据DPI来放大程序，那么就可以得到很清晰的界面效果。程序自己处理DPI的过程就是DPI适配。

现在开发PC客户端很有必要考虑对高DPI的支持。微软自己推出的软件普遍对高DPI支持的很好，但是当前国内很多PC客户端对高分屏的支持力度不够。如果软件本身不支持高DPI而用户设置了高DPI，反而会让软件变得模糊。云信Duilib对整体代码进行改造后，云信3.5版本已经初步支持了高DPI适配。本文就是关于如何把旧版本的云信Demo升级为支持高DPI功能新Demo的说明文档。

开启高DPI适配

在初始化Duilib时，为Startup函数的第三个参数传入bool值，可以设定Duilib是否开启DPI适配。另外在云信Demo3.5版本里，主界面的菜单里有选项来设置是否适配DPI。DPI的设置需要重启程序生效。

	bool adapt_api = ConfigHelper::GetInstance()->IsAdaptDpi();
	ui::GlobalManager::Startup(theme_dir + L"themes\\default", ui::CreateControlCallback(), adapt_api, language);

Duilib新增的接口

Duilib新增了DpiManager类来统一管理DPI缩放，其中提供了SetScale、ScaleSize、ScalePoint、ScaleRect等接口，会把传入的数据根据当前的DPI缩放比例来缩放，方便我们得到缩放后的数据

Duilib的Window::SetPos函数修改了参数，第二个参数bNeedDpiScale代表调用SetPos函数时，传入的窗口尺寸，是否需要经过DPI缩放。如果传入的窗口尺寸，并没有经过DPI缩放计算，则bNeedDpiScale应该传入true

void SetPos(const UiRect& rc, bool bNeedDpiScale, UINT uFlags, HWND hWndInsertAfter = NULL, bool bContainShadow = false);

需要修改的代码

为了让老版本代码支持Duilib的DPI适配功能，需要修改一下Demo层的部分代码，Demo层中涉及到设置窗口尺寸的代码，都需要修改一下代码。

• nim_demo项目中main.cpp文件中MainThread::Init()函数里初始化Duilib时，修改初始化函数ui::GlobalManager::Startup的参数，开启Duilib的DPI适配功能

• 以下地方，调用SetPos函数的代码，bNeedDpiScale参数填写为false

  1. shared项目中菜单控件ui_menu.cpp文件中CMenuWnd::Show函数
  2. ui_kit项目中team_callback.cpp文件中TeamNotifyForm* GetTeamNotifyForm函数
  3. ui_kit项目中link_form.cpp文件中ShowLinkForm函数
  4. ui_kit项目中emoji_form.cpp文件中EmojiForm::ShowEmoj函数
  5. ui_kit项目中at_list_form.cpp文件中AtlistForm::SetShowPos函数
  6. ui_kit项目中screen_capture_tool.cpp文件中ScreenCaptureTool::InitWindow函数
  7. ui_kit项目中drag_form.cpp文件中DragForm::LowLevelMouseProc函数
  8. ui_kit项目中drag_form.cpp文件中DragForm::CreateDragForm函数
  9. ui_kit项目中session_manager_dragdrop.cpp文件中SessionManager::OnAfterDragSessionBox函数

• 以下地方，调用SetPos函数的代码，bNeedDpiScale参数填写为true

  1. ui_kit项目中session_form.cpp文件中SessionForm::AdjustFormSize函数
  2. ui_kit项目中video_form_ui.cpp文件中VideoForm::AdjustWindowSize函数
  3. ui_kit项目中session_manager_dragdrop.cpp文件中SessionManager::SetEnableMerge函数
  4. image_view项目中image_view_form.cpp文件中ImageViewForm::StartViewPic函数

• 以下地方，参考云信Demo3.5版本来修改代码，涉及到缩放窗口尺寸

  1. ui_kit项目中bubble_notify.cpp文件中MsgBubbleNotice::OnResized函数
  2. ui_kit项目中bubble_text.cpp文件中MsgBubbleText::EstimateSize函数
  3. ui_kit项目中session_box_ui.cpp文件中SessionBox::OnBtnEmoji函数
  4. ui_kit项目中richedit_util.cpp文件中Re_InsertFace函数

未完成的功能

我们现在的Duilib开启DPI适配后，会根据DPI缩放比例，来缩放字体，绘制图形的尺寸。但是还不支持适配多套DPI素材（即根据DPI值去加载不同尺寸的素材，这些素材需要提前做好），未来会考虑增加此功能的支持